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String (字符 串 ) 
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人 
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SortedSet (有 序 集合 ) 
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来 源 : 


e Redis 教程 
e Redis 命令 参考 


整理 : 飞龙 


Redis 教程 


Redis 简介 


Redis 是 完全 开源 免费 的 ， 遵 守 BSD 协 议 ， 是 一 个 高 性 能 的 key-value 数 据 库 。 
Redis 与 其 他 key - value 缓存 产品 有 以 下 三 个 特点 : 


e Redis 支 持 数据 的 持久 化 ， 可 以 将 内 存 中 的 数据 保持 在 磁盘 中 ， 重 启 的 时 候 可 
以 再 次 加 载 进行 使 用 。 

e Redis 不 仅仅 支持 简单 的 key-value 类 型 的 数据 ， 同 时 还 提供 list，set，zset, 
hash 等 数据 结构 的 存储 。 

e Redis 支 持 数据 的 各 份 ， 即 master-slave 模 式 的 数据 各 份 。 


Redis 41% 3% 


e 性 能 极 高 - Redis 能 读 的 速度 是 110000 次 /s, 写 的 速度 是 81000 次 /s 。 

。 丰富 的 数据 类 型 ~ Redis 支 持 二 进 制 案例 的 Strings, Lists, Hashes, Sets 及 
Ordered Sets 数据 类 型 操作 。 

e 原子 — Redis 的 所 有 操作 都 是 原子 性 的 ， 同 时 Redis 还 支持 对 几 个 操作 全 并 后 的 
原子 性 执行 。 

e 丰富 的 特性 - Redis 还 支持 publish/subscribe, 通知 , key 过 期 等 等 特性 。 


Redis 与 其 他 key-value 存 储 有 什么 不 同 ? 


e Redisx 有 着 更 为 复 条 的 数据 结构 并 且 提 供 对 他 们 的 原子 性 操作 ， 这 是 一 个 不 同 
于 其 他 数据 库 的 进化 路 径 。Redis 的 数据 类 型 都 是 基于 基本 数据 结构 的 同时 对 
程序 员 透 明 ， 无 需 进行 额外 的 抽象 。 

Redis 运 行 在 内 存 中 但 是 可 以 持久 化 到 磁盘 ， 所 以 在 对 不 同 数据 集 进 行 高 速 读 
写 时 需要 权衡 内 存 ， 应 为 数据 量 不 能 大 于 硬件 内 存 。 在 内 存 数 据 库 方面 的 另 一 
个 优点 是 ， 相 比 在 磁盘 上 相同 的 复杂 的 数据 结构 ， 在 内 存 中 操作 起 来 非常 简 

单 ， 这 样 Redis 可 以 做 很 多 内 部 复杂 性 很 强 的 事情 。 同时 ， 在 磁盘 格式 方面 他 
们 是 紧凑 的 以 追加 的 方式 产生 的 ， 因 为 他 们 并 不 需要 进行 随机 访问 。 


Redis 安装 


Window 下 安装 


下 载 地 址 : https://github.com/dmajkic/redis/downloads。 


下 载 到 的 Redis 支 持 32bit 和 64bit。 根 据 自己 实际 情况 选择 ， 将 64bit 的 内 容 cp 到 自 定 
义 意 符 安装 目录 取 名 redis。 如 C:\reids 


打开 一 个 cmd 窗 口 使 用 cd 命令 切换 目录 到 C:\redis 运行 redis-server.exe 
redis.conf 。 


如 果 想 方便 的 话 ， 可 以 把 redis 的 路 径 加 到 系统 的 环境 变量 里 ， 这 样 就 省 得 再 
了 ， 后 面 的 那个 redis.conf 可 以 省 略 ， 如 果 省 略 ， 会 启用 默认 的 。 输 入 之 后 ， 


如 下 界面 : 


13 Sep 14:36:13 * Server started. Redis version 2.4.5 
13 Sep 14:36:13 x DB loaded from disk: @ seconds 


13 Sep 14:36:13 * The server is now ready to accept connections 


13 Sep 14:36:14 DB O: 1 keys <A volatile> in 4 slots HT. 
13 Sep 14:36:14 O clients connected <A slaves), 672860 bytes 
13 Sep 14:36:26 DB @: 1 keys <A volatile> in 4 slots HT. 
13 Sep 14:36:26 A clients connected (@ slaves», 672866 bytes 
13 Sep 14:36:25 DB O: 1 keys <Ø volatile> in 4 slots HT. 
13 Sep 14:36:25 O clients connected <A slaves). 672860 bytes 
13 Sep 14:36:31 DB ØO: 1 keys <A volatile? in 4 slots HT. 
13 Sep 14:36:31 Ø clients connected (@ slaves). 672860 bytes 
13 Sep 14:36:36 DB @: 1 keys (@ volatile> in 4 slots HT. 
13 Sep 14:36:36 @ clients connected <A slaves). 672860 bytes 
13 Sep 14:36:42 DB O: 1 keys <Ø volatile> in 4 slots HT. 
13 Sep 14:36:42 @ clients connected (@ slaves). 672866 bytes 
13 Sep 14:36:47 DB O: 1 keys <A volatile? in 4 slots HT. 
13 Sep 14:36:47 @ clients connected <A slaves), 672866 bytes 
13 Sep 14:36:52 DB O: 1 keys (A volatile> in 4 slots HT. 
13 Sep 14:36:52 @ clients connected <A slaves), 672868 bytes 
13 Sep 14:36:58 DB O: 1 keys <A volatile> in 4 slots HT. 
13 Sep 14:36:58 A clients connected (@ slaves»), 672866 bytes 
13 Sep 14:37:63 DB O: 1 keys <Ø volatile> in 4 slots HT. 
13 Sep 14:37:03 A clients connected <A slaves). 672860 bytes 





这 时 候 别 馈 一 个 cmd 窗 口 ， 原 来 的 不 要 关闭 ， 不 然 就 无 法 访问 服务 端 了 。 
切换 到 redis 目 录 下 运行 redis-cli.exe -h 127.0.0.1 -p 6379 。 
设置 键 值 对 set myKey abc 

取出 键 值 对 get myKey 


输 路 和 


对 
Aus 
会 显 不 


-|O}x 





iC: \wedis>redis-cli.exe -h 127.0.0.1 -p 6379 
127.6.6.1:6379> 
127.6.8.1:6379> set myKey abc 


127.6.6.1:6379> get myKey 


127.6.8.1:6379> 





Linux 下 安装 
下 载 地 址 : ， 下 载 最 新 文档 版 本 。 
本 教程 使 用 的 最 新 文档 版 本 为 2.8.17， 下 载 并 安装 : 


$ wget http://download.redis.io/releases/redis-2.8.17.tar.gz 
$ tar xzf redis-2.8.17.tar.gz 

$ cd redis-2.8.17 

$ make 


make 完 后 redis-2.8.17 目 录 下 会 出 现 编译 后 的 redis 服 务 程 序 redis-server 还 有 用 于 
测试 的 客户 端 程序 redis-cli 


下 面 启动 redis 服 务 . 


$ ./redis-server 


注意 这 种 方式 启动 redis 使 用 的 是 默认 配置 。 也 可 以 通过 启动 参数 告诉 redis 使 用 指 
定 配置 文件 使 用 下 面 命令 启动 。 


$ ./redis-server redis.conf 








redis.conf 是 一 个 默认 的 配置 文件 。 我 们 可 以 根据 需要 使 用 自己 的 配置 文件 。 
启动 redis 服 务 进 程 后 ， 就 可 以 使 用 测试 客户 端 程序 redis-cli 和 redis 服 务 交 互 了 。 
如 : 


$ ./redis-cli 
redis> set foo bar 
OK 

redis> get foo 
"bar" 


Ubuntu 下 安装 
在 Ubuntu 系统 安装 Redi 可 以 使 用 以 下 命 兮 : 


$sudo apt-get update 
$sudo apt-get install redis-server 


启动 Redis 


$redis-server 


查看 redis 2B 4H? 
$redis-cli 

以 上 命令 将 打开 以 下 终端 : 
redis 127.0.0.1:6379> 


127.0.0.1 是 本 机 IP ，6379 是 redis 服务 端口 。 现 在 我 们 输入 PING 命令。 


redis 127.0.0.1:6379> ping 
PONG 


以 上 说 明 我 们 已 经 成 功 安 装 了 redis。 


比 


Redis 配置 


Redis 的 配置 文件 位 于 Redis 安装 目录 下 ， 文 件 名 为 redis.conf。 
你 可 以 通过 CONFIG 命令 查看 或 设置 配置 项 。 


语法 
Redis CONFIG 命令 格式 如 下 : 


redis 127.0.0.1:6379&gt; CONFIG GET CONFIG_SETTING_NAME 


实例 


redis 127.0.0.1:6379> CONFIG GET loglevel 


1) "loglevel" 
2) "notice" 


使 用 * 号 获取 所 有 配置 项 : 
实例 


redis 127.0.0.1:6379> CONFIG GET * 


1) "dbfilename" 


2) "dump. rdb" 

3) "requirepass" 
4) "N 

5) "masterauth" 
6) "N 

7) "unixsocket" 
8) "N 

9) "logfile" 

10) "N 


11) "pidfile" 
12) "/var/run/redis.pid" 
13) "maxmemory" 


14) Wg" 
15) "maxmemory-samples" 
16) rea 


17) "timeout" 
18) "o" 


19) "tcp-keepalive" 


20) "Q" 
21) "auto-aof-rewrite-percentage" 
22) "100" 


23) "auto-aof-rewrite-min-size" 
24) "67108864" 
25) "hash-max-ziplist-entries" 


26) "512" 

27) "hash-max-ziplist-value" 
28) "64" 

29) "list-max-ziplist-entries" 
30) "512" 

31) "list-max-ziplist-value" 
32) "64" 

33) "set-max-intset-entries" 
34) "512" 

35) "zset-max-ziplist-entries" 
36) "128" 

37) "zset-max-ziplist-value" 
38) "64" 

39) "hll-sparse-max-bytes" 
40) "3000" 

41) "lua-time-limit" 

42) "5000" 

43) "slowlog-log-slower-than" 
44) "10000" 

45) "latency-monitor-threshold" 
46) "oQ" 

47) "slowlog-max-len" 

48) "128" 

49) "port" 

50) "6379" 

51) "tcp-backlog" 

52) "511" 

53) "databases" 

54) "76" 

55) "repl-ping-slave-period" 
56) "10" 

57) "repl-timeout" 

58) "50" 


59) "repl-backlog-size" 
60) "1048576" 
61) "repl-backlog-tt1" 


62) "3600" 

63) "maxclients" 

64) "4064" 

65) "watchdog-period" 

66) "oQ" 

67) "slave-priority" 

68) "100" 

69) "min-slaves-to-write" 
70) "oQ" 


71) "min-slaves-max-lag" 


72) "10" 


73) Rze 

74) "10" 

75) "no-appendfsync-on-rewrite" 
76) "no" 

77) "slave-serve-stale-data" 
78) "yes" 

79) "slave-read-only" 

80) "yes" 

81) "stop-writes-on-bgsave-error" 
82) "yes" 

83) "daemonize" 

84) "no" 

85) "rdbcompression" 

86) "yes" 

87) "rdbchecksum" 

88) "yes" 

89) "activerehashing" 

90) "yes" 

91) "repl-disable-tcp-nodelay" 
92) "no" 

93) "aof-rewrite-incremental-fsync" 
94) "ves" 

95) "appendonly" 

96) "no" 

97) "dir" 


98) "/home/deepak/Downloads/redis-2.8.13/src" 
99) "maxmemory-policy" 

100) "volatile-lru" 

101) "appendfsync" 

102) "everysec" 

103) "save" 

104) "3600 1 300 100 60 10000" 

105) "loglevel" 

106) "notice" 

107) "client -output-buffer-limit" 

108) "normal © 0 © slave 268435456 67108864 60 pubsub 33554432 838% 
109) "unixsocketperm" 


110) Wg" 

111) "slaveof" 

112) "N 

113) "notify-keyspace-events" 
114 ) "N 

115) "bind" 

116) "N 


EE 
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你 可 以 通过 修改 redis.conf 文件 或 使 用 CONFIG set 命令 来 修改 配置 。 


语法 
CONFIG SET 命令 基本 语法 : 


redis 127.0.0.1:6379> CONFIG SET CONFIG_SETTING_NAME NEW_CONFIG_VAI 
‘ eee 


“a 








实例 


redis 127.0.0.1:6379> CONFIG SET loglevel "notice" 
OK 
redis 127.0.0.1:6379> CONFIG GET loglevel 


1) "loglevel" 
2) "notice" 


参数 说 明 


redis.conf 配置 项 说 明 如 下 : 


1. Redis 默 认 不 是 以 守护 进程 的 方式 运行 ， 可 以 通过 该 配置 项 修改 ， 使 用 yes g AS 
护 进 程 


**daemonize no** 


2. 当 Redis 以 守 扩 进程 方式 运行 时 ，Redis 默 认 会 把 pid 写 入 /var/run/redis.pid 文 件 ， 
可 以 通过 pidfile 指 定 


**pidfile /var/run/redis.pid** 


3. 指定 Redis 监 听 端 口 ， 默 认 端 口 为 6379， 作 者 在 自己 的 一 篇 博文 中 解释 了 为 什么 
选用 6379 作 为 默认 端口 ， 因 为 6379 在 手机 按键 上 MERZ 对 应 的 号 码 ， 而 MERZ 取 自 
意大利 歌女 Alessia Merz 的 名 字 


**port 6379** 


4. 绑 定 的 主机 地 址 


* hand) 227 Orori > 


5. 当 客户 端 闲置 多 长 时 间 后 关闭 连接 ， 如 果 指 定 为 0， 表 示 关 闭 该 功能 


**timeout 300** 


6. 指定 日 志 记 录 级 别 ，Redis 总 共 支 持 四 个 级 别 : debug, verbose, notice, 
warning， 默 认为 verbose 


**loglevel verbose** 


7. 日 志 记 录 方 式 ， 默 认为 标准 输出 ， 如 果 配 置 Redis 为 守护 进程 方式 运行 ， 而 这 里 
又 配置 为 日 志 记 录 方 式 为 标准 输出 ， 则 日 志 将 会 发 送 给 /devnull 

**logfile stdout** 
8. 设置 数据 库 的 数量 ， 黑 认 数据 库 为 0， 可 以 使 用 SELECT <dbid> 命 令 在 连接 上 指 
定数 据 库 id 

**databases 16** 


9. 指定 在 多 长 时 间 内 ， 有 多 少 次 更 新 操作 ， 就 将 数据 同步 到 数据 文件 ， 可 以 多 个 条 
件 配合 


**save &lt;seconds&gt; &lt;changesé&gt ; ** 
Redis 默 认 配置 文件 中 提供 了 三 个 条 件 : 


**save 900 1** 


save 300 10 
save 60 10000 


分 别 表 示 900 秒 (15 分 钟 ) 内 有 1 个 更 改 ，300 秒 (5 分 钟 ) 内 有 10 个 更 改 以 及 60 秒 内 有 10( 
a 一 = 


10. 指定 存储 至 本 地 数据 库 时 是 否 不 缩 数据 ， 默 认为 yes，Redis 采 用 LZF 不 缩 ， 如 
果 为 了 节省 CPU 时 间 ， 可 以 关闭 该 选项 ， 但 会 导致 数据 库 文 件 变 的 巨大 





**rdbcompression yes** 


11. 指定 本 地 数据 库 文 件 名 ， 默 认 值 为 dump.rdb 


**dbfilename dump.rdb** 


12. 指定 本 地 数据 库存 放 目 录 


a 


= . 设置 当 本 机 为 slav 服 务 时 ， 设 置 master 服 务 的 IP 地 址 及 端口 ， 在 Redis 启动 时 ， 
会 自动 从 master 进 行 数 据 同 步 


**slaveof &lt;masterip&gt; &lt;masterporté&gt; ** 


14. 当 master 服 务 设 置 了 密码 保护 时 ，slav 服 务 连 接 master 的 密码 


**masterauth &lt;master-passwordé&gt; ** 


15. 设置 Redis 连 接 密码 ， 如 果 配 置 了 连接 密码 ， 客 户 端 在 连接 Redis 时 需要 通 
AUTH <password> 命 令 提 供 密码 ， 默 认 关 闭 


**requirepass foobared** 


16. 设置 同一 时 间 最 大 客户 端 连接 数 ， 黑 认 无 限制 ，Redis 可 以 同时 打开 的 客 户 端 连 
接 数 为 Redis 进 程 可 以 打开 的 最 大 文件 描述 符 数 ， 如 果 设 置 maxclients 0， 表 示 不 作 
限制 。 当 客户 端 连 接 数 到 达 限 制 时 ，Redis 会 关闭 新 的 连接 并 向 客户 端 返 回 max 
number of clients reached 错 误 信息 


**maxclients 128** 


17. 指定 Redis 最 大 内 存 限 制 ，Redis 在 启动 时 会 把 数据 加 载 到 内 存 中 ， 达 到 最 大 内 
存 后 ，Redis 会 先 尝试 清除 已 到 期 或 即将 到 期 的 Key， 当 此 方法 处 理 后 ， 仍 然 到 达 
最 大 内 存 设置 ， 将 无 法 再 进行 写 入 操作 ， 但 仍然 可 以 进行 读 取 操 作 。Redis 新 的 vm 
机 制 ， 会 把 Key 存 放 内 存 ，Value 会 存放 在 swap 区 


**maxmemory &lt;bytes&gt ; ** 


18. 指定 是 否 在 每 次 更 新 操作 后 进行 日 志 记 录 ，Redis 在 默认 情况 下 是 异步 的 把 数据 
写 入 磁盘 ， 如 果 不 开启 ， 可 能 会 在 断 电 时 导致 一 段 时 间 内 的 数据 丢失 。 因 为 redis 
本 身 同步 数据 文件 是 按 上 面 save 条 件 来 同步 的 ， 所 以 有 的 数据 会 在 一 段 时 间 内 只 存 
在 于 内 存 中 。 上 默认 为 no 


**appendonly no** 


19. 指定 更 新 日 志文 件 名 ， 黑 认为 appendonly.aof 


**appendfilename appendonly.aof** 


20. 指定 更 新 日 志 条 件 ， 共 有 3 个 可 选 值 : 

no : 表示 等 操作 系统 进行 数据 缓存 同步 到 磁盘 (IR) 

always : 表示 每 次 更 新 操作 后 手动 调用 fsync() 将 数据 写 到 磁盘 ( 慢 ， 安 全 ) 
everysec : 表示 每 秒 同 步 一 次 GTR, Mita) 


**appendfsync everysec** 


21. 指定 是 否 启 用 虚拟 内 存 机 制 ， 黑 认 值 为 no， 简 单 的 介绍 一 下 ，VM 机 制 将 数据 分 
页 存放 ， 由 Redis 将 访问 量 较 少 的 页 即 冷 数据 swap 到 磁盘 上 ， 访 问 多 的 页 面 由 磁盘 
自动 换 出 到 内 存 中 (在 后 面 的 文章 我 会 仔细 分 析 Redis 的 VM 机 制 |) 


**ym-enabled no** 


22. 虚拟 内 存 文件 路 径 ， 默 认 值 为 /tmp/redis.swap， 不 可 多 个 Redis 实 例 共享 


**vm-swap-file /tmp/redis.swap** 


23. 将 所 有 大 于 vm-max-memory 的 数据 存 入 虚拟 内 存 ,无 论 vm-max-memory 设 置 多 
小 ,所 有 索引 数据 都 是 内 存 存储 的 (Redis 的 索引 数据 就 是 keys), 也 就 是 说 , 当 vm-max- 
memory 设 置 为 0 的 时 候 ,其 实 是 所 有 value 都 存在 于 磁盘 。 默 认 值 为 0 


*xVm-max-memory 0** 


24. Redis swap 文 件 分 成 了 很 多 的 page， 一 个 对 象 可 以 保存 在 多 个 page 上 面 ， 但 一 
个 page 上 不 能 被 多 个 对 象 共享 ，vm-page-size 是 要 根据 存储 的 数据 大 小 来 设 定 

的 ， 作 者 建议 如 果 存 储 很 多 小 对 象 ，page 大 小 最 好 设置 为 32 或 者 64bytes ; MRE 
储 很 大 大 对 象 ， 则 可 以 使 用 更 大 的 page， 如 果 不 确定 ， 就 使 用 默认 值 


**ym-page-size 32** 


25. 设置 swap 文 件 中 的 page 数 量 ， 由 于 页 表 (一 种 表示 页 面 空闲 或 使 用 的 bitmap) 
是 在 放 在 内 存 中 的 ，， 在 磁盘 上 每 8 个 pages 将 消耗 1byte 的 内 存 。 


**yvm-pages 134217728** 


26. 设置 访问 swap 文 件 的 线程 数 ,最 好 不 要 超过 机 器 的 核 数 ,如 果 设 置 为 0, 那 么 所 有 对 
swap 文 件 的 操作 都 是 串 行 的 ， 可 能 会 造成 比较 长 时 间 的 延 妈 。 默 认 值 为 4 


**vm-max-threads 4** 
27. 设置 在 向 客户 端 应 答 时 ， 是 否 把 较 小 的 包 合并 为 一 个 包 发 送 ， 黑 认为 开启 


**glueoutputbuf yes** 


ee rs 采用 一 种 特殊 的 哈 
希 算 法 


**hash-max-zipmap-entries 64** 


hash-max-zipmap-value 512 
29. 指定 是 否 激活 重 置 哈 希 ， 默 认为 开启 (后面 在 介绍 Redis 的 哈 希 算法 时 具体 介 


绍 ) 


**activerehashing yes** 


30. 指定 包含 其 它 的 配置 文件 ， 可 以 在 同一 主机 上 多 个 Redis 实 例 之 间 使 用 同一 份 配 
置 文件 ， 而 同时 各 个 实例 又 拥有 自己 的 特定 配置 文件 


**include /path/to/local.conf** 


Redis 数据 类 型 


Redis 支 持 五 种 数据 类 型 : string (FAH) ，hash ( 哈 希 ) , list (列表 ) , 
set (集合 ) 及 zset(sorted set : 有 序 集合 )。 


String (FFE) 
string 是 redis 最 基本 的 类 型 ， 你 可 以 理解 成 与 Memcached 一 模 一 样 的 类 型 ， 一 个 
key 对 应 一 个 value。 


string 类 型 是 二 进 制 安全 的 。 意 思 是 redis 的 string 可 以 包含 任何 数据 。 上 比如 jpg 图 片 或 
者 序列 化 的 对 象 。 


string 类 型 是 Redis 最 基本 的 数据 类 型 ， 一 个 键 最 大 能 存储 512MB。 
实例 


redis 127.0.0.1:6379> SET name "w3cschool.cc" 
OK 

redis 127.0.0.1:6379> GET name 

"w3cschool.cc" 


在 以 上 实例 中 我 们 使 用 了 Redis 的 SET 和 GET 命令 。 键 为 name， 对 应 的 值 为 
W3cschool.cc。 


注意 : 一 个 键 最 大 能 存储 512MB。 


Hash ( 哈 希 ) 


Redis hash 是 一 个 键 值 对 集合 。 
Redis hash 是 一 个 string 类 型 的 field 和 value 的 映射 表 ，hash 特 别 适 合用 于 存储 对 


o 


实例 


redis 127.0.0.1:6379> HMSET user:1 username w3cschool.cc password v 
OK 

redis 127.0.0.1:6379> HGETALL user:1 

1) "username" 

2) "w3cschool.cc" 

3) "password" 

4) "w3cschool.cc" 

5) "points" 

6) "200" 

redis 127.0.0.1:6379> 








以 上 实例 中 hash 数据 类 型 存储 了 包含 用 户 脚本 信息 的 用 户 对 象 。 实例 中 我 们 使 用 
了 Redis HMSET, HEGTALL AS, user:1 为 键 值 。 


每 个 hash 可 以 存储 232 - 1 键 值 对 (40 多 亿 ) 。 


List (JUR) 


Redis 的 list 类 型 其 实 就 是 一 个 每 个 子 元 素 都 是 string 类 型 的 双向 链表 。 你 可 以 将 元 
素 添 加 到 列表 的 头 和 尾 。 


实例 


redis 127. 
(integer ) 
redis 127. 
(integer ) 
redis 127. 
(integer ) 
redis 127. 
1) "rabitmq" 
2) "mongodb" 
3) "redis" 
redis 127.0.0.1:6379> 


0.1:6379> lpush w3cschool.cc redis 
.0.1:6379> lpush w3cschool.cc mongodb 


.0.1:6379> lpush w3cschool.cc rabitmq 


OWONOPO 


.0.1:6379> lrange w3cschool.cc © 10 


列表 最 多 可 存储 2<sup>32 - 1</sup> 元 素 (4294967295, 每 个 列表 可 存储 40 多 
亿 )。 


set (集合 ) 


Redis 的 set 是 string 类 型 的 无 序 
set 的 是 通过 hash table 实 现 的 ， 所 以 添加 ， 删 除 ， 查 找 的 复杂 度 都 是 O(1)。 


sadd MS 


添加 一 个 string 元 素 到 ,key 对 应 的 set 集 合 中 ， 成 功 返 回 1, 如 果 元 素 以 及 在 集合 中 返 
回 0,key 对 应 的 set 不 存在 返回 错误 。 


sadd key member 


实例 


redis 127.0.0.1:6379> sadd w3cschool.cc redis 
(integer) 1 

redis 127.0.0.1:6379> sadd w3cschool.cc mongodb 
(integer) 1 

redis 127.0.0.1:6379> sadd w3cschool.cc rabitmq 
(integer) 1 

redis 127.0 
(integer) 0 
redis 127.0 


.0.1:6379> sadd w3cschool.cc rabitmq 
.0.1:6379> smembers w3cschool.cc 
1) "rabitmg" 


2) "mongodb" 
3) "redis" 


注意 : 以 上 实例 中 rabitmg 添加 了 两 次 ， 但 根据 集合 内 元 素 的 唯一 性 ， 第 二 次 插入 
的 元 素 将 被 忽略 。 

集合 中 最 大 的 成 员 数 为 2<sup>32 - 1</sup> (4294967295, 每 个 集合 可 存储 40 多 亿 
个 成 员 )。 


zset(sorted set : 有 序 集合 ) 


Redis zset 和 set 一 样 也 是 string 类 型 元 素 的 集合 , 且 不 人 允许 重复 的 成 员 。 


不 同 的 是 每 个 元 素 都 会 关联 一 个 double 类 型 的 score。redis 正 是 通过 分 数 来 为 集合 
中 的 成 员 进 行 从 小 到 大 的 排序 。 


zset 的 成 员 是 唯一 的 ,但 分 数 (score) 却 可 以 重复 。 


zadd S 


添加 元 素 到 集合 ; 元 素 在 集合 中 存在 则 更 新 对 应 score 


zadd key score member 


实例 


redis 127.0.0.1:6379> zadd w3cschool.cc 0 redis 

(integer) 1 

redis 127.0.0.1:6379> zadd w3cschool.cc © mongodb 

(integer) 1 

redis 127.0.0.1:6379> zadd w3cschool.cc © rabitmq 
1 
0 
0 
0 


(integer) 


redis 127.0.0.1:6379> zadd w3cschool.cc © rabitmq 
(integer) 

redis 127.0.0.1:6379> ZRANGEBYSCORE w3cschool.cc 0 1000 
1) "redis" 

2) "mongodb" 


3) "rabitmq" 


Redis MS 


Redis 命令 用 于 在 redis 服务 上 执行 操作 。 


要 在 redis 服务 上 执行 命令 需要 一 个 redis 客户 端 。Redis 客户 端 在 我 们 之 前 下 载 的 
的 redis 的 安装 包 中 。 


语法 
Redis 客户 端的 基本 语法 为 : 


$ redis-cli 


实例 
以 下 实例 讲解 了 如 何 启动 redis 客户 端 : 


启动 redis 客户 端 ， 打 开 终 端 并 输入 命令 redis-cli。 该 命令 会 连接 本 地 的 redis AR 
务 。 


$redis-cli 
redis 127.0.0.1:6379> 
redis 127.0.0.1:6379> PING 


PONG 


在 以 上 实例 中 我 们 连接 到 本 地 的 redis 服务 并 执行 PING RSD, AmMBAFR I 
redis 服务 是 否 启 动 。 


在 远程 服务 上 执行 命 倒 
如 果 需 要 在 远程 redis 服务 上 执行 命 售 ， 同 祥 我 们 使 用 的 也 是 redis-cli 命令 。 
语法 


$ redis-cli -h host -p port -a password 


实例 


以 下 实例 演示 了 如 何 连接 到 主机 为 127.0.0.1， 端 口 为 6379 ， 密 码 为 mypass 的 
redis 服务 上 。 


$redis-cli -h 127.0.0.1 -p 6379 -a "mypass" 
redis 127.0.0.1:6379> 
redis 127.0.0.1:6379> PING 


PONG 


Redis 数据 各 份 与 恢复 
Redis SAVE 命令 用 于 创建 当前 数据 库 的 备份 。 


语法 
redis Save 命令 基本 语法 如 下 : 


redis 127.0.0.1:6379> SAVE 


实例 


redis 127.0.0.1:6379> SAVE 
OK 


该 命令 将 在 redis 安装 目录 中 创建 dump.rdb 文 件 。 


恢复 数据 


如 果 需 要 恢复 数据 ， 只 需 业 各 份 文件 (dump.rdb) 移动 到 redis 安装 目录 并 启动 服务 
即 可 。 获 取 redis 目录 可 以 使 用 CONFIG 命令 ， 如 下 所 示 : 


redis 127.0.0.1:6379> CONFIG GET dir 
al aaa ll 
2) "/usr/local/redis/bin" 


以 上 命令 CONFIG GET dir 输出 的 redis 安装 目录 为 /usr/local/redis/bin。 
Bgsave 

创建 redis 各 份 文 件 也 可 以 使 用 命令 BGSAVE， 该 命令 在 后 台 执 行 。 
实例 


127.0.0.1:6379> BGSAVE 


Background saving started 
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Redis 安全 


我 们 可 以 通过 redis 的 配置 文件 设置 密码 参数 ， 这 样 客户 端 连 接 到 redis 服务 就 需 
要 密码 验证 ， 这 样 可 以 让 你 的 redis 服务 更 安全 。 


实例 
我 们 可 以 通过 以 下 命令 查看 是 否 设置 了 密码 验证 : 


127.0.0.1:6379> CONFIG get requirepass 
1) "requirepass" 
2) "N 


默认 情况 下 requirepass 参数 是 空 的 ， 这 就 意味 着 你 无 需 通 过 密码 验证 就 可 以 连接 
到 redis 服务 。 


你 可 以 通过 以 下 命令 来 修改 该 参数 : 


127.0.0.1:6379> CONFIG set requirepass "w3cschool.cc" 
OK 

127.0.0.1:6379> CONFIG get requirepass 

1) "requirepass" 

2) "w3cschool.cc" 


设置 密码 后 ， 客 户 端 连 接 redis 服务 就 需要 密码 验证 ， 否 则 无 法 执行 命令 。 


AUTH 命令 基本 语法 格式 如 下 : 


127.0.0.1:6379> AUTH password 


实例 


127.0.0.1:6379> AUTH "w3cschool.cc" 

OK 

127.0.0.1:6379> SET mykey "Test value" 
OK 

127.0.0.1:6379> GET mykey 

"Test value" 


Redis 性 能 测试 
Redis 性 能 测试 是 通过 同时 执行 多 个 命令 实现 的 。 


语法 
redis 性 能 测试 的 基本 命令 如 下 : 


redis-benchmark [option] [option value] 


实例 
以 下 实例 同时 执行 10000 个 请 求 来 检测 性 能 : 


redis-benchmark -n 100000 


PING_INLINE: 141043.72 requests per second 

PING BULK: 142857.14 requests per second 

SET: 141442.72 requests per second 

GET: 145348.83 requests per second 

INCR: 137362.64 requests per second 

LPUSH: 145348.83 requests per second 

LPOP: 146198.83 requests per second 

SADD: 146198.83 requests per second 

SPOP: 149253.73 requests per second 

LPUSH (needed to benchmark LRANGE): 148588.42 requests per second 
LRANGE_100 (first 100 elements): 58411.21 requests per second 
LRANGE_300 (first 300 elements): 21195.42 requests per second 
LRANGE_500 (first 450 elements): 14539.11 requests per second 
LRANGE_600 (first 600 elements): 10504.20 requests per second 
MSET (10 keys): 93283.58 requests per second 


UES ëO 
redis 性 能 测试 工具 可 选 参数 如 下 所 示 : 


序号 。 选项 描述 默认 值 
1 -h 指定 服务 器 主机 名 127.0.0.1 
2 -p 指定 服务 器 端口 6379 
3 -S 指定 服务 器 socket 
4 -C 指定 并 发 连接 数 50 
5 -n 指定 请 求 数 10000 
6 -d 以 字 节 的 形式 指定 SET/GET 值 的 数据 大 小 2 
7 -k 1=keep alive 0=reconnect 1 
8 -r SET/GET/INCR 使 用 随机 key, SADD 使 用 随机 值 
9 -P 通过 管道 传输 <numreq> 请 求 1 
10 -q 强制 退出 redis。 仅 显示 query/sec 值 
11 --CSV ”以 CSV 格式 输出 
12 -| 生成 循环 ， 永 久 执 行 测试 
13 -t 仅 运行 以 逗号 分 隔 的 测试 命 爷 列 表 。 
14 -| Idle 模式 。 仅 打开 N 个 idle 连接 并 等 待 。 
实例 


以 下 实例 我 们 使 用 了 多 个 参数 来 测试 redis 性 能 : 


redis-benchmark -h 127.0.0.1 -p 6379 -t set,lpush -n 100000 -q 
SET: 146198.83 requests per second 
LPUSH: 145560.41 requests per second 


以 上 实例 中 主机 为 127.0.0.1， 端 口号 为 6379， 执 行 的 命令 为 set,lpush， 请 求 数 为 
10000， 通 过 -q 参数 让 结果 只 显示 每 秒 执行 的 请 求 数 。 


Redis 客户 端 连 接 


Redis 通过 监听 一 个 TCP 端口 或 者 Unix socket 的 方式 来 接收 来 自 客户 端的 连接 ， 
当 一 个 连接 建立 后 ，Redis 内 部 会 进行 以 下 一 些 操作 : 
。 首先 ， 客 户 端 socket 会 被 设置 为 非 阻塞 模式 ， 因 为 Redis 在 网 络 事件 处 理 上 
采用 的 是 非 阻塞 多 路 复 用 模型 。 
e 然后 为 这 个 socket 设置 TCP_NODELAY 属性 ， 禁 用 Nagle 算法 
。 然后 创建 一 个 可 读 的 文件 事件 用 于 监听 这 个 客户 册 socket 的 数据 发 送 


最 大 连接 数 


在 Redis2.4 中 ， 最 大 连接 数 是 被 直接 硬 编码 在 代码 里 面 的 ， 而 在 2.6 版 本 中 这 个 值 
变 成 可 配置 的 。 


maxclients 的 默认 值 是 10000， 你 也 可 以 在 redis.conf 中 对 这 个 值 进行 修改 。 


config get maxclients 


1) "maxclients" 
2) "10000" 


实例 
以 下 实例 我 们 在 服务 启动 时 设置 最 大 连接 数 为 100000 : 


redis-server --maxclients 100000 


客户 端 命 全 
CLIENT LIST 返回 连接 到 redis 服务 的 客户 端 列 表 
CLIENT SETNAME 设置 当前 连接 的 名 称 
CLIENT GETNAME ” “获取 通过 CLIENT SETNAME 命令 设置 的 服务 名 称 
CLIENT PAUSE 生起 客户 端 连接 ， 指 定 挂 起 的 时 间 以 毫秒 计 


CLIENT KILL 关闭 客户 端 连 接 


Redis 管道 技术 
Redis 是 一 种 基于 客户 端 -服务 端 模型 以 及 请 求 /响应 协议 的 TCP 服 务 。 这 意味 着 通常 
情况 下 一 个 请 求 会 遵循 以 下 步骤 : 
e 客户 端 向 服务 端 发 送 一 个 查询 请 求 ， 并 监听 Socket 返 回 ， 通 常 是 以 阻塞 模式 ， 
等 待 服 务 端 响应 。 
。 服务 端 处理 命令 ， 并 将 结果 返回 给 客户 端 。 
Redis 管道 技术 
Redis 管道 技术 可 以 在 服务 端 未 响应 时 ， 客 户 端 可 以 继续 向 服务 端 发 送 请 求 ， 并 最 
终 一 次 性 读 取 所 有 服务 端的 响应 。 
实例 
查看 redis 管道 ， 只 需要 启动 redis 实例 并 输入 以 下 命令 : 


$(echo -en "PING\r\n SET w3ckey redis\r\nGET w3ckey\r\nINCR visitoi 


+PONG 
十 OK 
redis 





以 上 实例 中 我 们 通过 使 用 PING 命令 查看 redis 服 务 是 否 可 用 ， 之 后 我 们 们 设置 了 
w3ckey 的 值 为 redis， 然 后 我 们 获取 w3ckey 的 值 并 使 得 visitor 自 增 3 次 。 


在 返回 的 结果 中 我 们 可 以 看 到 这 些 命令 一 次 性 向 redis 服务 提交 ， 并 最 终 一 次 性 读 
取 所 有 服务 端的 响应 


管道 扩 术 的 优势 
管道 技术 最 显著 的 优势 是 提高 了 redis 服务 的 性 能 。 


一 些 测试 数据 


在 下 面 的 测试 中 ， 我 们 将 使 用 Redis 的 Ruby 客 户 端 ， 支 持 管道 技术 特性 ， 测 试管 道 
技术 对 速度 的 提升 效果 。 


require 'rubygems' 

require 'redis' 

def bench(descr ) 

start = Time.now 

yield 

puts "#{descr} #{Time.now-start} seconds" 
end 

def without_pipelining 

r = Redis.new 

10000.times { 


r.ping 
} 


end 
def with_pipelining 
r = Redis.new 
r.pipelined { 
10000.times { 
r.ping 
} 


} 


end 
bench("without pipelining") { 
without_pipelining 


} 

bench("with pipelining") { 
with_pipelining 

} 


从 处 于 局 域 网 中 的 Mac OS X 系 统 上 执行 上 面 这 个 简单 脚本 的 数据 表明 ， 开 启 了 管 
道 操作 后 ， 往 返 时 延 已 经 被 改善 SET, 


without pipelining 1.185238 seconds 
with pipelining 0.250783 seconds 


RPL, FS ela, Fei REM TS ots. 


Redis 分 区 


分 区 是 分 割 数 据 到 多 个 Redis 实 例 的 处 理 过 程 ， 因 此 每 个 实例 只 保存 key 的 一 


o 


分 区 的 优势 

。 通过 利用 多 台 计 算 机 内 存 的 和 值 ， 人 允许 我 们 构造 更 大 的 数据 库 。 

P een 
器 ， 人 允许 我 们 扩展 网 络 带 宽 。 

分 区 的 不 足 


redis 的 一 些 特性 在 分 区 方面 表现 的 不 是 很 好 : 


e。 涉及 多 个 key 的 操作 通常 是 不 被 支持 的 。 举 例 来 说 ， 当 两 个 set 映 射 到 不 同 的 
redis 实 例 上 时 ， 你 就 不 能 对 这 两 个 set 执 行 交 集 操作 。 

© 涉及 多 个 key 的 redis 事 务 不 能 使 用 。 

eo 当 使 用 分 区 时 ， 数 据 处 理 较 为 复杂 ， 上 比如 你 需要 人 处理 多 个 rdb/aof 文 件 ， 并 且 从 

多 个 实例 和 主机 备份 持久 化 文件 。 

增加 或 删除 容量 也 比较 复 厅 。redis 集 群 大 多 数 支 持 在 运行 时 增加 、 删 除 节点 的 

透明 数据 平衡 的 能 力 ， 但 是 类 似 于 客户 端 分 区 、 代 理 等 其 他 系统 则 不 支持 这 项 

特性 。 然 而 ， 一 种 叫做 presharding 的 技术 对 此 是 有 帮助 的 。 


分 区 类 型 


Redis 有 两 种 类 型 分 区 。 假设 有 4 个 Redis 实 例 RO, R1, R2, R3, Al #Lluser:1, 
user2 这 样 的 表示 用 户 的 多 个 key， 对 既定 的 key 有 多 种 不 同方 式 来 选择 这 个 key 存 
放 在 哪个 实例 中 。 也 就 是 说 ， 有 不 同 的 系统 来 映射 某 个 key 到 某 个 Redis 服 务 。 


范围 分 区 
最 简单 的 分 区 方式 是 按 范围 分 区 ， 就 是 映射 一 定 范围 的 对 象 到 特定 的 Redis 实 例 。 


比如 ，ID 从 0 到 10000 的 用 户 会 保存 到 实例 R0，ID 从 10001 到 20000 的 用 户 会 保存 
到 R1， 以 此 类 推 。 

这 种 方式 是 可 行 的 ， 并 且 在 实际 中 使 用 ， 不 足 就 是 要 有 一 个 区 间 范 围 到 实例 的 映射 
表 。 这 个 表 要 被 管理 ， 同 时 还 需要 各 种 对 象 的 映射 表 ， 通 常 对 Redis 来 说 并 非 是 好 
的 方法 。 


哈 希 分 区 


另外 一 种 分 区 方法 是 hash 分 区 。 这 对 任何 key 都 适用 ， 也 无 需 是 object_name:<id> 
这 种 形式 ， 像 下 面 描述 的 一 样 简单 : </id> 


。 用 一 个 hash 画 数 将 key 转 换 为 一 个 数字 ， 上 比如 使 用 crc32 hash 画 数 。 对 key 
foobar 执 行 crc32(foobanr) 会 输出 类 似 93024922 的 整数 。 

。 对 这 个 整数 取 模 ， 将 其 转化 为 0-3 之 间 的 数字 ， 就 可 以 将 这 个 整数 映射 到 4 个 
Redis 实 例 中 的 一 个 了 。93024922 % 4 = 2， 就 是 说 key foobar 应 该 被 存 到 R2 
实例 中 。 注 意 : 取 模 操作 是 取 除 的 余数 ， 通 常 在 多 种 编程 语言 中 用 % 操 作 符 实 
现 。 


Java 使 用 Redis 
安装 


开始 在 Java 中 使 用 Redis 前 ， 我 们 需要 确保 已 经 安装 了 redis 服务 及 Java redis 
驱动 ， 且 你 的 机 器 上 能 正常 使 用 Java. Java 的 安装 配置 可 以 参考 我 们 的 Java 开 发 
环境 配置 接 下 来 让 我 们 安装 Java redis 驱动 : 


。 首先 你 需要 下 载 驱 动 包 ， 下 载 jedis.jar， 确 保 下 载 最 新 驱动 包 。 
。 在 你 的 classpath 中 包含 该 驱动 包 。 


连接 到 redis 服务 


import redis.clients.jedis.Jedis; 
public class RedisJava { 
public static void main(String[] args) { 
// 连 接 本 地 的 Redis 服务 
Jedis jedis = new Jedis("localhost"); 
System.out.println("Connection to server sucessfully"); 
// 查 看 服务 是 否 运 行 
System,out,println("Server is running: "+jedis.ping()); 


编译 以 上 Java 程序 ， 确 保 驱 动 包 的 路 径 是 正确 的 。 


$javac RedisJava. java 

$java RedisJava 

Connection to server sucessfully 
Server is running: PONG 


Redis Java String Example 


Redis Java String( 字 符 串 ) 实例 


import redis.clients.jedis.Jedis; 
public class RedisStringJava { 
public static void main(String[] args) { 
// 连 接 本 地 的 Redis 服务 
Jedis jedis = new Jedis("localhost"); 
System.out.println("Connection to server sucessfully"); 
// 设 置 redis 字符 串 数据 
jedis.set("w3ckey", "Redis tutorial"); 
// 获取 存储 的 数据 并 输出 
System.out.printin("Stored string in redis:: "+ jedis.get("w3 





编译 以 上 程序 。 


$javac RedisStringJava.java 

$java RedisStringJava 

Connection to server sucessfully 

Stored string in redis:: Redis tutorial 


Redis Java List( 列 表 ) 实例 


import redis.clients.jedis.Jedis; 
public class RedisListJava { 
public static void main(String[] args) { 
// 连 接 本 地 的 Redis 服务 
Jedis jedis = new Jedis("localhost"); 
System.out.println("Connection to server sucessfully"); 
// 存 储 数据 到 列表 中 
jedis.lpush("tutorial-list", "Redis"); 
jedis.lpush("tutorial-list", "Mongodb"); 
jedis.lpush("tutorial-list", "Mysql"); 
// 获取 存储 的 数据 并 输出 
List<String> list = jedis.lrange("tutorial-list", 0 ,5); 
for(int i=0; i<list.size(); i++) { 
System.out.println("Stored string in redis:: "+list.get(i)); 
} 
t 
} 


a] = — Rh] 
编译 以 上 程序 。 








$javac RedisListJava.java 

$java RedisListJava 

Connection to server sucessfully 
Stored string in redis:: Redis 
Stored string in redis:: Mongodb 
Stored string in redis:: Mysql 


Redis Java Keys 实例 


import redis.clients.jedis.Jedis; 
public class RedisKeyJava { 
public static void main(String[] args) { 
// 连 接 本 地 的 Redis 服务 
Jedis jedis = new Jedis("localhost"); 
System.out.println("Connection to server sucessfully"); 


// 获取 数据 并 输出 
List<String> list = jedis.keys("*"); 
for(int i=0; i<list.size(); i++) { 
System.out.println("List of stored keys:: "+list.get(i)); 
} 
} 


编译 以 上 程序 。 


$javac RedisKeyJava. java 

$java RedisKeyJava 

Connection to server sucessfully 
List of stored keys:: tutorial-name 
List of stored keys:: tutorial-list 


PHP 使 用 Redis 


oh 


YE 
安装 


开始 在 PHP 中 使 用 Redis 前 ， 我 们 需要 确保 已 经 安装 了 redis 服务 及 PHP redis 
驱动 ， 且 你 的 机 器 上 能 正常 使 用 PHP。 接 下 来 让 我 们 安装 PHP redis 驱动 : FR 
地 址 为 :https://github.com/nicolasff/phpredis。 


PHP 安 小 redis 扩 展 
/usr/local/php/bin/phpize #php 安 装 后 的 路 径 


./configure --with-php-config=/usr/local/php/bin/php-config 


make && make install 


(Et php.ini sc 
vi /usr/local/php/1lib/php. ini 


增加 如 下 内 容 : 


extension_dir = "/usr/local/php/lib/php/extensions/no-debug -zts -20( 


extension=redis.so 





_ i 
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Phar based on pear/PHP_Archive, original concept by Davey Shafik. 





Phar fully realized by Gregory Beaver and Marcus Boerger. 
Portions of tar implementation Copyright (c) 2003-2009 Tim Kientzle. 
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连接 到 redis 服务 


<?php 
// 连 接 本 地 的 Redis 服务 
$redis = new Redis(); 
$redis->connect('127.0.0.1', 6379); 
echo "Connection to server sucessfully"; 
// 查 看 服务 是 否 运行 
echo "Server is running: "+ $redis->ping(); 
?> 


执行 脚本 ， 输 出 结果 为 : 


Connection to server sucessfully 
Server is running: PONG 


Redis Java String( 字 符 串 ) 实例 


<?php 
// 连 接 本 地 的 Redis 服务 
$redis = new Redis(); 
$redis->connect('127.0.0.1', 6379); 
echo "Connection to server sucessfully"; 
// 设 置 redis 字符 串 数据 
$redis->set("tutorial-name", "Redis tutorial"); 
// 获取 存储 的 数据 并 输出 
echo "Stored string in redis:: " + jedis.get("tutorial-name"); 


| 


执行 脚本 ， 输 出 结果 为 : 


Connection to server sucessfully 
Stored string in redis:: Redis tutorial 


Redis Java List( 列 表 ) 实例 


<?php 
// 连 接 本 地 的 Redis 服务 

$redis = new Redis(); 
$redis->connect('127.0.0.1', 6379); 

echo "Connection to server sucessfully"; 

// 存 储 数据 到 列表 中 

$redis->lpush("tutorial-list", "Redis"); 
$redis->lpush("tutorial-list", "Mongodb"); 
$redis->lpush("tutorial-list", "Mysql"); 

// 获取 存储 的 数据 并 输出 

$arList = $redis->lrange("tutorial-list", © ,5); 
echo "Stored string in redis:: " 
print_r($arList); 


执行 脚本 ， 输 出 结果 为 : 


Connection to server sucessfully 
Stored string in redis:: 

Redis 

Mongodb 

Mysql 


Redis Java Keys 实例 


<?php 
// 连 接 本 地 的 Redis 服务 

$redis = new Redis(); 
$redis->connect('127.0.0.1', 6379); 

echo "Connection to server sucessfully"; 
// 获取 数据 并 输出 

$arList = $redis->keys("*"); 
echo "Stored keys in redis:: 
print_r($arList); 


执行 脚本 ， 输 出 结果 为 : 


Connection to server sucessfully 
Stored string in redis:: 
tutorial-name 

tutorial-list 


DEL 


DEL key [key ...] 

删除 给 定 的 一 个 或 多 个 key 。 
不 存在 的 key 会 被 忽略 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 


O(N), N 为 被 删除 的 key 的 数量 。 删 除 单个 字符 串 类 型 的 key ， 时 间 复 杀 
度 为 O(1)。 删 除 单个 列表 、 人 集合 、 有 序 集 合 或 哈 希 表 类 型 的 key ， 时 间 复 条 度 为 
O(M)， M 为 以 上 数据 结构 内 的 元 素数 量 。 


返回 值 : 
被 删除 key 的 数量 。 


# MRAD key 


redis> SET name huangz 
OK 


redis> DEL name 
(integer) 1 


# 删除 一 个 不 存在 的 key 


redis> EXISTS phone 
(integer) 0 


redis> DEL phone # 失败 ， 没 有 key 被 删除 
(integer) 0 


# 同时 删除 多 个 key 


redis> SET name "redis" 
OK 


redis> SET type "key-value store" 
OK 


redis> SET website "redis.com" 
OK 


redis> DEL name type website 
(integer) 3 


DUMP 


DUMP key 


序列 化 给 定 key ， 并 返回 被 序列 化 的 值 ， 使 用 RESTORE 命令 可 以 将 这 个 值 反 
序列 化 为 Redis 键 。 


序列 化 生成 的 值 有 以 下 几 个 特点 : 


。 它 带 有 64 位 的 校 验 和 ， 用 于 检测 错误 ， RESTORE 在 进行 反 序 列 化 之 前 会 先 
检查 校 验 和 。 

e 值 的 编码 格式 和 RDB 文件 保持 一 致 。 

e RDB 版 本 会 被 编码 在 序列 化 值 当中 ， 如 果 因 为 Redis 的 版 本 不 同 造成 RDB 格 
式 不 兼容 ， 那 么 Redis 会 拒绝 对 这 个 值 进行 反 序列 化 操作 。 


序列 化 的 值 不 包括 任何 生存 时 间 信 息 。 
可 用 版 本 : 

>= 2.6.0 

at a] SAE: 


查找 给 定 键 的 复 杀 度 为 O(1) ， 对 键 进行 序列 化 的 复 条 度 为 O(N*M) ， 其 中 N 是 构 
成 key 的 Redis 对 象 的 数量 ， 而 M 则 是 这 些 对 象 的 平均 大 小 。 如 果 序 列 化 的 对 
象 是 比较 小 的 字符 串 ， 那 么 复杂 度 为 O(1) 。 


返回 值 : 
如 果 key 不 存在 ， 那 么 返回 nil 。 否 则 ， 返 回 序列 化 之 后 的 值 。 


redis> SET greeting "hello, dumping world!" 
OK 


redis> DUMP greeting 
"\x0O\xi5hello, dumping world! \xO06\xO0E\xaOZ\x82\xd8r\xci\xde" 


redis> DUMP not-exists-key 
(nil) 


Key (4) 


EXISTS 


EXISTS key 
检查 给 定 key 是 否 存在 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 


aq key 存在， 返回 1 ， 否 则 返回 6 。 
redis> SET db "redis" 


OK 


redis> EXISTS db 
(integer) 1 


redis> DEL db 
(integer) 1 


redis> EXISTS db 
(integer) 0 


EXPIRE 


EXPIRE key seconds 


JAE key 设置 生存 时 间 ， 当 key 过 期 时 (生存 时 间 为 ”9 )， 它 会 被 自动 删 
除 o 


在 Redis 中 ， 带 有 生存 时 间 的 key 被 称 为 『 易 失 的 」 (volatile)。 


生存 时 间 可 以 通过 使 用 DEL 命令 来 删除 整个 key 来 移 除 ， 或 者 被 SET 和 
GETSET 命令 覆 写 (overwrite)， 这 意味 着 ， 如 果 一 个 命令 只 是 修改 (alten) 一 个 带 生 
存 时 间 的 key 的 值 而 不 是 用 一 个 新 的 key 值 来 代替 (replace) 它 的 话 ， 那 么 生存 
时 间 不 会 被 改变 。 


比如 说 ， 对 一 个 key 执行 INCR 命 舍 ， 对 一 个 列表 进行 LPUSH 命 舍 ， 或 者 对 一 
个 哈 希 表 执 行 HSET 命 售 ， 这 类 操作 都 不 会 修改 key 本 身 的 生存 时 间 。 


另 一 方面 ， 如 果 使 用 RENAME 对 一 个 key 进行 改名 ， 那 么 改名 后 的 key 的 生 
存 时 间 和 改名 前 一 样 。 


RENAME 命令 的 另 一 种 可 能 是 ， 尝 试 将 一 个 带 生存 时 间 的 ”key 改名 成 另 一 个 带 
生存 时 间 的 another_key ， 这 时 旧 的 another_key (以 及 它 的 生存 时 间 ) 会 被 
删除 ， 然 后 旧 的 key 会 改名 为 another_key ， 因 此 ， 新 的 another_key 的 
生存 时 间 也 和 原本 的 key 一 样 。 


使 用 PERSIST 命令 可 以 在 不 删除 key 的 情况 下 ， 移 除 key 的 生存 时 间 ， 让 
key 重新 成 为 一 个 『 持 久 的 」(persistent) key o 


更 新 生存 时 间 


可 以 对 一 个 已 经 带 有 生存 时 间 的 key 执行 EXPIRE 命 爷 ， 新 指定 的 生存 时 间 会 
取代 旧 的 生存 时 间 。 


过 期 时 间 的 精确 度 


在 Redis 2.4 版 本 中 ， 过 期 时 间 的 延迟 在 1 秒 钟 之 内 一 一 也 即 是 ， 就 算 key B 
经 过 期 ， 但 它 还 是 可 能 在 过 期 之 后 一 秒 钟 之 内 被 访问 到 ， 而 在 新 的 Redis 2.6 版 本 
中 ， 延 迟 被 降低 到 1 毫秒 之 内 。 


Redis 2.1.3 之 前 的 不 同 之 处 


在 Redis 2.1.3 之 前 的 版 本 中 ， 修 改 一 个 带 有 生存 时 间 的 key 会 导致 整个 key 
被 删除 ， 这 一 行为 是 受 当 时 复制 (replication) 层 的 限制 而 作出 的 ， 现 在 这 一 限制 已 经 
被 修复 。 


可 用 版 本 : 
>= 1.0.0 
时 间 复 杂 度 : 


O(1) 
WON 4a : 


设置 成 功 返 回 1 。 当 key 不 存在 或 者 不 能 为 key 设置 生存 时 间 时 (比如 在 低 
于 2.1.3 版 本 的 Redis 中 你 尝试 更 新 key 的 生存 时 间 )， 返 回 6 。 


redis> SET cache_page "www.google.com" 
OK 


redis> EXPIRE cache_page 30 # 设置 过 期 时 间 为 30 秒 
(integer) 1 


redis> TTL cache_page # 查看 剩余 生存 时 间 
(integer) 23 


redis> EXPIRE cache_page 30000 # 更 新 过 期 时 间 
(integer) 1 


redis> TTL cache_page 
(integer) 29996 


模式 : 导航 会 话 


假设 你 有 一 项 web 服务 ， ey 户 最 近 访 问 的 N 个 页 面 来 进行 物品 推荐 ， 并 
且 假设 用 户 停止 阅览 超过 60 秒 ， 那 么 就 清空 阅览 记录 (为 了 减少 物品 推荐 的 计算 
量 ， HL RHEE). 


这 些 最 近 访 问 的 页 面 记 录 ， 我 们 称 之 为 『 导 航 会 话 〗(Navigation session), ALAR 
INCR 和 RPUSH APRH Redis 中 实现 它 : 每 当 用 户 阅览 一 个 网 页 的 时 候 ， 执 行 以 
下 代码 : 


MULTI 
RPUSH pagewviews.user:<userid> http://..... 
EXPIRE pagewviews.user:<userid> 60 

EXEC 


如 果 用 户 停止 阅览 超过 60 秒 ， 那 么 它 的 导航 会 话 就 会 被 清空 ， 当 用 户 重新 开始 阅 
览 的 时 候 ， 条 统 又 会 重新 记录 导航 会 话 ， 继续 进行 物品 推荐 。 


EXPIREAT 


EXPIREAT key timestamp 

EXPIREAT 的 作用 和 EXPIRE 类 似 ， 都 用 于 为 key 设置 生存 时 间 。 

不 同 在 于 EXPIREAT 命令 接受 的 时 间 参 数 是 UNIX 时 间 惟 (unix timestamp). 

可 用 版 本 : 

>= 1.2.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

如 果 生 存 时 间 设 置 成 功 ， 返 回 1 。 当 key 不 存在 或 没 办 法 设置 生存 时 间 ， 返 回 


0 。 


redis> SET cache www.google.com 
OK 


redis> EXPIREAT cache 1355292000 # 这 个 key 将 在 2012.12.12 过 期 
(integer) 1 


redis> TTL cache 
(integer) 45081860 


ay | 


KEYS 


KEYS pattern 
查找 所 有 符合 给 定 模式 pattern 的 key o 


KEYS * 匹配 数据 库 中 所 有 key o KEYS h?llo 匹配 hello , hallo 和 
hxllo 等 。 KEYS h*llo 匹配 hllo 和 heeeeello 等 。 KEYS h[ae]llo 
匹配 hello 和 hallo ， 但 不 匹配 hillo 。 


特殊 符号 用 \ Brat 
Warning 


KEYS 的 速度 非常 快 ， 但 在 一 个 大 的 数据 库 中 使 用 它 仍然 可 能 造成 性 能 问题 ， 如 果 
你 需要 从 一 个 数据 集中 查找 特定 的 key ， 你 最 好 还 是 用 Redis 的 集合 结构 (set) 来 
RE. 


可 用 版 本 : 
>= 1.0.0 
时 间 复 杂 度 : 
O(N), N 为 数据 库 中 key 的 数量 。 
Wl) 4a : 
符合 给 定 模 式 的 key 列表。 
Bette? MSET one 1 two 2 three 3 four 4 # 一 次 设置 4 个 key 


redis> KEYS *o* 


1) "four" 
2) "two" 
3) "one" 


redis> KEYS t?? 


1) "two" 

redis> KEYS t[w]* 

1) "two" 

redis> KEYS * # 匹配 数据 库 内 所 有 key 
四 是 ol 

2) "three" 

3) "two" 


4) "one" 


W3School Redis 教程 & 命令 参考 


KEYS 


MIGRATE 


MIGRATE host port key destination-db timeout [COPY] [REPLACE] 


将 key 原子 性 地 从 当前 实例 传送 到 目标 实例 的 指定 数据 库 上 ， 一 旦 传送 成 功 ， 
key 保证 会 出 现在 目标 实例 上 ， 而 当前 实例 上 的 key 会 被 删除 。 


这 个 命令 是 一 个 原子 操作 ， 它 在 执行 的 时 候 会 阻塞 进行 迁移 的 两 个 实例 ， 直 到 以 下 
任意 结果 发 生 : 迁移 成 功 ， 迁 移 失 败 ， 等 到 超时 。 


命令 的 内 部 实现 是 这 样 的 : 它 在 当前 实例 对 给 定 key 执行 DUMP RS, Bo 
列 化 ， 然 后 传送 到 目标 实例 ， 目 标 实例 再 使 用 RESTORE 对 数据 进行 反 序列 化 ， 并 
将 反 序 列 化 所 得 的 数据 添加 到 数据 库 中 ; 当前 实例 就 像 目 标 实 例 的 客户 端 那样 ， 只 
要 看 到 RESTORE 命令 返回 ok ， 它 就 会 调用 DEL 删除 自己 数据 库 上 的 key 


o 


timeout 参数 以 毫秒 为 格式 ， 指 定 当 前 实例 和 目标 实例 进行 沟通 的 最 大 间隔 时 
间 。 这 说 明 操 作 并 不 一 定 要 在 timeout 毫秒 内 完成 ， 只 是 说 数据 传送 的 时 间 不 能 
超过 这 个 timeout 数 。 


MIGRATE 命令 需要 在 给 定 的 时 间 规定 内 完成 IO 操作 。 如 果 在 传送 数据 时 发 生 IO 
错误 ， 或 者 达到 了 超时 时 间 ， 那 么 命令 会 停止 执行 ， 并 返回 一 个 特殊 的 错误 : 
IOERR >o 


当 IOERR 出 现时 ， 有 以 下 两 种 可 能 : 


e key 可 能 存在 于 两 个 实例 
e key 可 能 只 存在 于 当前 实例 


唯一 不 可 能 发 生 的 情况 就 是 丢失 key ， 因 此 ， 如 果 一 个 客户 端 执 行 MIGRATE 命 
令 ， 并 且 不 幸 遇 上 IOERR 错误 ， 那 么 这 个 客户 端 唯一 要 做 的 就 是 检查 自己 数据 库 
上 的 key 是 否 已 经 被 正确 地 删除 。 


如 果 有 其 他 错误 发 生 ， 那 么 MIGRATE 保证 key 只 会 出 现在 当前 实例 中 。 (4 
然 ， 目 标 实例 的 给 定数 据 库 上 可 能 有 和 key 同名 的 键 ， 不 过 这 和 MIGRATE AS 
没有 关系 ) 。 


可 选项 : 


e COPY :不 移 除 源 实例 上 的 key 。 
e REPLACE : 替换 目标 实例 上 已 存在 的 key 。 


可 用 版 本 : 
>= 2.6.0 
时 间 复 杂 度 : 


这 个 命令 在 源 实 例 上 实际 执行 DUMP 命令 和 DEL 命令 ， 在 目标 实例 执行 
RESTORE 命令 ， 查 看 以 上 命令 的 文档 可 以 看 到 详细 的 复 末 度 说 明 。 key 数据 在 
两 个 实例 之 间 传 输 的 复杂 度 为 O(N)。 


返回 值 : 
迁移 成 功 时 返回 0K ， 否 则 返回 相应 的 错误 。 


示例 
先 启 动 两 个 Redis 实例 ， 一 个 使 用 默认 的 6379 端口 ， 一 个 使 用 7777 端口 。 


$ ./redis-server & 
[1] 3557 


$ ./redis-server --port 7777 & 
[2] 3560 


然后 用 客户 端 连 上 6379 ? 岩 口 的 实例 ， 设 置 一 个 键 ， 然 后 将 它 迁 移 到 7777 端口 的 
实例 上 


$ ./redis-cli 


redis 127.0.0.1:6379> flushdb 
OK 


redis 127.0.0.1:6379> SET greeting "Hello from 6379 instance" 
OK 


redis 127.0.0.1:6379> MIGRATE 127.0.0.1 7777 greeting 0 1000 
OK 


redis 127.0.0.1:6379> EXISTS greeting # j 
(integer) 0 


Ki aay 





使 用 另 一 个 客户 端 ， 查 看 7777 端口 上 的 实例 : 


$ ./redis-cli -p 7777 


redis 127.0.0.1:7777> GET greeting 
"Hello from 6379 instance" 


MOVE 


MOVE key db 
将 当前 数据 库 的 key 移动 到 给 定 的 数据 库 db 4H, 


如 果 当 前 数据 库 ( 源 数据 库 ) 和 给 定数 据 库 ( 目 标 数据 库 ) 有 相同 名 字 的 给 定 key ， 
或 者 key 不 存在 于 当前 数据 库 ， 那 么 MOVE 没有 任何 效果 。 


因此 ， 也 可 以 利用 这 一 特性 ， 将 MOVE 当 作 锁 (locking) 原 语 (primitive)。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

移动 成 功 返 回 1 ， 失 败 则 返回 o 。 


# key 存在 于 当前 数据 库 


redis> SELECT 0 # redis 默 认 使 用 数据 库 0， 
OK 


redis> SET song "Secret base - Zone" 


OK 
redis> MOVE song 1 # 将 song 移动 到 数据 库 1 
(integer) 1 

redis> EXISTS song # song 已 经 被 移 走 
(integer) 0 

redis> SELECT 1 # 使 用 数据 库 1 

OK 

redis:1> EXISTS song # 证 实 song RE) TMF 


(integer) 1 
# 当 key 不 存在 的 时 候 


redis:1> EXISTS fake_key 
(integer) 9 


redis:1> MOVE fake_key 0 # 试图 从 数据 库 1 移动 一 个 7 
(integer) 0 


tt 


redis:1> select 0 使 用 数据 库 0 


OK 


redis> EXISTS fake_key # 证 实 fake_key 不 存在 
(integer) 0 


# 当 源 数据 库 和 目标 数据 库 有 相同 的 key 时 


redis> SELECT 0 # 使 用 数据 库 0 
OK 

redis> SET favorite fruit "banana" 

OK 


redis> SELECT 1 # 使 用 数据 库 1 
OK 

redis:1> SET favorite_fruit "apple" 

OK 


redis:1> SELECT 0 # 使 用 数据 库 9， 并 试图 将 fa 
OK 


redis> MOVE favorite fruit 1 # 因为 两 个 数据 库 有 相同 的 k 
(integer) 0 


redis> GET favorite fruit # 数据 库 9 的 favorite_f 
"banana" 


redis> SELECT 1 
OK 


redis:1> GET favorite fruit # 数据 库 1 的 favorite_f 
"apple" 


Aoo g 





OBJECT 


OBJECT subcommand [arguments [arguments]] 
OBJECT 命令 允许 从 内 部 察看 给 定 key 的 Redis 对 象 。 
它 通常 用 在 除 错 (debugging) 或 者 了 解 为 了 节省 空间 而 对 key 使 用 特殊 编码 的 情 


Tho 


当 将 Redis 用 作 缓 存 程序 时 ， 你 也 可 以 通过 OBJECT 命令 中 的 信息 ， 决 定 


key 的 驱逐 策略 (eviction policies)。 
OBJECT 命令 有 多 个 子 命令 : 


OBJECT REFCOUNT &lt;key&gt; 返回 给 定 key 引用 所 储存 的 值 的 次 数 。 
此 命令 主要 用 于 除 错 。 
OBJECT ENCODING &lt;key&gt; 返回 给 定 key 锁 储存 的 值 所 使 用 的 内 部 
表示 (representation)。 


OBJECT IDLETIME &lt;key&gt; 返回 给 定 key 自 储存 以 来 的 空 闪 时 间 
(idle, 没有 被 读 取 也 没有 被 写 人 )， 以 秒 为 单位 。 对 象 可 以 以 多 种 方式 编码 : 
字符 串 可 以 被 编码 为 ”raw (一 般 字符 串 ) 或 int (为 了 节约 内 存 ，Redis 会 将 
字符 串 表 示 的 64 位 有 符号 整数 编码 为 整数 来 进行 储存 ) 。 

列表 可 以 被 编码 为 ziplist 或 linkedlist > ziplist 是 为 节约 大 小 
较 小 的 列表 空间 而 作 的 特殊 表示 。 

集合 可 以 被 编码 为 intset 或 者 hashtable > intset 是 只 储存 数字 的 
小 集合 的 特殊 表示 。 

哈 希 表 可 以 编码 为 zipmap 或 者 hashtable > zipmap 是 小 哈 希 表 的 特 
殊 表示 。 

有 序 集合 可 以 被 编码 为 ziplist 或 者 skiplist 格式 。 ziplist 用 于 
表示 小 的 有 序 集合 ， 而 skiplist e e 。 假 如 你 
做 了 什么 让 Redis 没 办 法 再 使 用 节省 空间 的 编码 时 (比如 将 一 只 有 1 个 元 素 
的 集合 扩展 为 一 个 有 100 万 个 元 素 的 集合 )， 特 殊 编码 类 sat encoded 
types) 会 自动 转换 成 通用 类 型 (general type). 


可 用 版 本 : 

>= 2.2.3 

时 间 复 条 度 : 

O(1) 

返回 值 : 

REFCOUNT 和 IDLETIME 返回 数字 。 ENCODING 返回 相应 的 编码 类 型 。 


ra 


redis> SET game "COD" # 设置 一 个 字符 串 


OK 

redis> OBJECT REFCOUNT game # 只 有 一 个 引用 

(integer) 1 

redis> OBJECT IDLETIME game # 等 待 一 阵 。。。 然 后 查看 空闲 时 间 
(integer) 90 

redis> GET game # 提取 game， 让 它 处 于 活跃 (active) 状 态 
"COD" 

redis> OBJECT IDLETIME game # 不 再 处 于 空闲 状态 

(integer) 0 

redis> OBJECT ENCODING game # 字符 串 的 编码 方式 

"raw" 


redis> SET big-number 23102930128301091820391092019203810281029831( 
OK 


redis> OBJECT ENCODING big-number 
W raw" 


redis> SET small-number 12345 #4 而 短 的 数字 则 会 被 编码 为 整数 
OK 


redis> OBJECT ENCODING small-number 
"int W 
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PERSIST 


PERSIST key 


移 除 给 定 key 的 生存 时 间 ， 将 这 个 key 从 『 易 失 的 」( 带 生存 时 间 key ) 转 换 
成 『 持 久 的 」( 一 个 不 带 生 存 时 间 、 永 不 过 期 的 key )。 


可 用 版 本 : 
>= 2.2.0 
时 间 复 条 度 : 
O(1) 
返回 值 : 
当 生 存 时 间 移 除 成 功 时 ， 返 回 1 .如 果 key 不 存在 或 key 没有 设置 生存 时 
la], RE © 。 
redis> SET mykey "Hello" 


OK 


redis> EXPIRE mykey 10 # 为 key 设置 生存 时 间 
(integer) 1 


redis> TTL mykey 
(integer) 10 


redis> PERSIST mykey # 移 除 key 的 生存 时 间 
(integer) 1 


redis> TTL mykey 
(integer) -1 


PEXPIRE 


PEXPIRE key milliseconds 


这 个 命 伟 和 EXPIRE 命 合 的 作用 类 似 ， 但 是 它 以 毫秒 为 单位 设置 key 的 生存 时 
间 ， 而 不 像 EXPIRE 命令 那样 ， 以 秒 为 单位 。 


可 用 版 本 : 

>= 2.6.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

设置 成 功 ， 返 回 1 key 不 存在 或 设置 失败 ， 返 回 o 
redis> SET mykey "Hello" 
OK 


redis> PEXPIRE mykey 1500 
(integer) 1 


redis> TTL mykey # TTL 的 返回 值 以 秒 为 单位 
(integer) 2 


redis> PTTL mykey # PTTL 可 以 给 出 准确 的 毫秒 数 
(integer) 1499 


PEXPIREAT 


PEXPIREAT key milliseconds-timestamp 


这 个 命 全 和 EXPIREAT 命令 类 似 ， 但 它 以 毫秒 为 单位 设置 key 的 过 期 unix 时 间 
By, mae EXPIREAT 那样 ， 以 秒 为 单位 。 


可 用 版 本 : 
>= 2.6.0 

时 间 复 杂 度 : 
O(1) 

Wl) a : 


如 果 生 存 时 间 设 置 成 功 ， 返 回 1 。 当 key 不 存在 或 没 办 法 设置 生存 时 间 时 ， 返 
El o 。( 查 看 EXPIRE 命令 获取 更 多 信息 ) 


XI 


redis> SET mykey "Hello" 
OK 


redis> PEXPIREAT mykey 1555555555005 
(integer) 1 


redis> TTL mykey # TTL 返回 秒 
(integer) 223157079 


redis> PTTL mykey # PTTL 返回 毫秒 
(integer) 223157079318 


PTTL 


PTTL key 


这 个 命令 类 似 于 TTL et, BEZA Stokoe key 的 剩余 生存 时 间 ， 而 不 
是 像 TTL 命令 那样 ， 以 秒 为 单位 。 


可 用 版 本 : 
>= 2.6.0 
SRE: 
O(1) 
返回 值 : 


当 key 不 存在 时 ， 返 回 -2 。 当 key 存在 但 没有 设置 剩余 生存 时 间 时 ， 返 回 
-1 。 否 则 ， 以 毫秒 为 单位 ， 返 回 key 的 剩余 生存 时 间 。 


Note 


在 Redis 2.8 以 前 ， 当 key AEE, RE key 没有 设置 剩余 生存 时 间 时 ， 命 
都 返回 -1 。 


中 


# 不 存在 的 key 


redis> FLUSHDB 
OK 


redis> PTTL key 
(integer) -2 


# key 存在 ， 但 没有 设置 剩余 生存 时 间 


redis> SET key value 
OK 


redis> PTTL key 
(integer) -1 


# 有 剩余 生存 时 间 的 key 


redis> PEXPIRE key 10086 
(integer) 1 


redis> PTTL key 
(integer) 6179 


RANDOMKEY 


RANDOMKEY 

从 当前 数据 库 中 随机 返回 (不 删除 ) 一 个 key 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

当 数 据 库 不 为 空 时 ， 返 回 一 个 key 。 当 数据 库 为 空 时 ， 返 回 nil 。 


# 数据 库 不 为 空 


redis> MSET fruit "apple" drink "beer" food "cookies" # 设置 多 个 k 
OK 


redis> RANDOMKEY 
Ci 


redis> RANDOMKEY 
"food" 


redis> KEYS * # 查看 数据 库 内 所 有 key， 证 明 RANDOMKEY 并 不 删除 key 
1) "food" 


2) "drink" 
3) "fruit" 
# 数据 库 为 空 


redis> FLUSHDB # 删除 当前 数据 库 所 有 key 
OK 


redis> RANDOMKEY 
(nil) 
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RENAME 


RENAME key newkey 

将 key 改名 为 newkey 。 

当 key 和 newkey 相同 ， 或 者 ”key 不 存在 时 ， 返 回 一 个 错误 。 
当 newkey 已 经 存在 时 ， RENAME 命令 将 覆盖 旧 值 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

Wl) 4a : 

改名 成 功 时 提示 OK ， 失 败 时 候 返 回 一 个 错误 。 


# key 存在 且 newkey 不 存在 


redis> SET message "hello world" 
OK 


redis> RENAME message greeting 
OK 


redis> EXISTS message # message 不 复 存 在 
(integer) 0 


redis> EXISTS greeting # greeting 取而代之 
(integer) 1 


# 4 key 不 存在 时 ， 返 回 错误 


redis> RENAME fake_key never_exists 
(error) ERR no such key 


# newkey 已 存在 时 ， RENAME 会 覆盖 | 日 newkey 


redis> SET pc "lenovo" 
OK 


redis> SET personal_computer "dell" 
OK 


redis> RENAME pc personal_computer 
OK 


redis> GET pc 
(nil) 


redis:1> GET personal_computer # 原来 的 值 dell 被 覆盖 了 
"Lenovo" 


RENAMENX 


RENAMENX key newkey 

当 且 仅 当 newkey 不 存在 时 ,将 key 改名 为 newkey o 
当 key 不 存在 时 ， 返 回 一 个 错误 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

修改 成 功 时 ， 返 回 1 。 如 果 newkey 已 经 存在 ， 返 回 0 。 


# newkey 不 存在 ， 改 名 成 功 


redis> SET player "MPlyaer" 
OK 


redis> EXISTS best_player 
(integer) 0 


redis> RENAMENX player best_player 
(integer) 1 


#_newkey 存 在 时 ， 失 败 


redis> SET animal "bear" 
OK 


redis> SET favorite_animal "butterfly" 
OK 


redis> RENAMENX animal favorite_animal 
(integer) 0 


redis> get animal 
"bear" 


redis> get favorite animal 
"butterfly" 


RESTORE 


RESTORE key ttl serialized-value [REPLACE] 
反 序列 化 给 定 的 序列 化 值 ， 并 将 它 和 给 定 的 key 关联 。 


参数 ttl 以 毫秒 为 单位 为 key 设置 生存 时 间 ; 如 果 ttl 为 0 ， 那 么 不 设 
etry i. 


RESTORE 在 执行 反 序列 化 之 前 会 先 对 序列 化 值 的 RDB 版 本 和 数据 校 验 和 进行 检 
查 ， 如 果 RDB 版 本 不 相同 或 者 数据 不 完整 的 话 ， 那 么 RESTORE 会 拒绝 进行 反 序 
列 化 ， 并 返回 一 个 错误 。 


如 果 键 key 已 经 存在 ， 并 且 给 定 了 REPLACE 选项 ， 那么 使 用 反 序 列 化 得 出 的 
值 来 代替 键 key 原 有 的 值 ; 相反 地 ， 如 果 键 key 已 经 存在 ， 但 是 没有 给 定 
REPLACE 选项 ， 那么 命令 返回 一 个 错误 。 


更 多 信息 可 以 参考 DUMP 命令。 
可 用 版 本 : 

>= 2.6.0 

时 间 复 杂 度 : 


查找 给 定 键 的 复杂 度 为 O(1) ， 对 键 进行 反 序列 化 的 复杂 度 为 O(N/M) ， 其 中 N 是 构 
成 key 的 Redis 对 象 的 数量 ， 而 M 则 是 这 些 对 象 的 平均 大 小 。 有 序 集合 (sorted 
set) 的 反 序列 化 复杂 度 为 O(NM*log(N)) ， 因 为 有 序 集合 每 次 插入 的 复杂 度 为 
O(log(N)) 。 如 果 反 序列 化 的 对 象 是 比较 小 的 字符 串 ， 那 么 复杂 度 为 O(1) 。 

返回 值 : 


如 果 反 序列 化 成 功 那么 返回 ok ， 否 则 返回 一 个 错误 。 


# 创建 一 个 键 ， 作 为 DUMP MBNA 


redis> SET greeting "hello, dumping world!" 
OK 


redis> DUMP greeting 
"\x0O\xi5hello, dumping world! \xO06\xO0E\xaOZ\x82\xd8r\xci\xde" 


# 将 序列 化 数据 RESTORE 到 另 一 个 键 上 面 


redis> RESTORE greeting-again © "\x00\xi5hello, dumping world! \x06* 
OK 


redis> GET greeting-again 
"hello, dumping world!" 


# 在 没有 给 定 REPLACE 选项 的 情况 下 ， 再 次 党 试 反 序 列 化 到 同一 个 键 ， 失 败 


redis> RESTORE greeting-again © "\x00\x15hello, dumping world! \x06‘ 
(error) ERR Target key name is busy. 


# 给 定 REPLACE 选项 ， 对 同一 个 键 进行 反 序列 化 成 功 


redis> RESTORE greeting-again © "\x00\x15hello, dumping world! \x06‘ 
OK 


H 尝试 使 用 无 效 的 值 进行 反 序列 化 ， 出 错 


redis> RESTORE fake-message 0 "hello moto moto blah blah" 
(error) ERR DUMP payload version or checksum are wrong 


EE) 





SORT 

SORT key [BY pattern] [LIMIT offset count] [GET pattern [GET pattern ...]] 
[ASC | DESC] [ALPHA] [STORE destination] 

返回 或 保存 给 定 列 表 、 集 合 、 有 序 集合 key 中 经 过 排序 的 元 素 。 

排序 默认 以 数字 作为 对 象 ， 值 被 解释 为 双 精 度 浮 点 数 ， 然 后 进行 比较 。 


一 般 SORT 用 法 


最 简单 的 SORT 使 用 方法 是 SORT key 和 SORT key DESC 


e SORT key 返回 键 值 从 小 到 大 排序 的 结果 。 
e SORT key DESC 返回 键 值 从 大 到 小 排序 的 结果 。 


假设 today_cost 列表 保存 了 今日 的 开销 金额 ， 那么 可 以 用 SORT 命令 对 它 进 
行 排序 : 


# 开销 金额 列表 


redis> LPUSH today cost 30 1.5 10 8 
(integer) 4 


# 排序 


redis> SORT today_cost 
1) Wa ye 

2) Urey 

3) "476" 

4) "30" 


# 逆序 排序 


redis 127.0.0.1:6379> SORT today_cost DESC 
1) "30" 

2) "410" 

3) WQU 

Aes: 


使 用 ALPHA 修饰 符 对 字符 串 进行 排序 


因为 SORT 命令 默认 排序 对 象 为 数字 ， 当 需 要 对 字符 串 进行 排序 时 ， 需要 显 式 地 
在 SORT 命令 之 后 添加 ALPHA 修饰 符 : 


# 网 址 


redis> LPUSH website "www.reddit.com" 
(integer) 1 


redis> LPUSH website "www.slashdot.com" 
(integer) 2 


redis> LPUSH website "www. infoq.com" 
(integer) 3 


# 默认 〈 按 数字 ) 排序 


redis> SORT website 
1) "www.infoq.com" 

2) "www.slashdot.com" 
3) "www.reddit.com" 


# 按 字符 排序 


redis> SORT website ALPHA 
1) "www.infog.com" 

2) "www.reddit.com" 

3) "www.slashdot.com" 


如 果 系 统 正 确 地 设置 了 LC_COLLATE 环境 变量 的 话 ，Redis 能 识别 UTF-8 2 
码 。 


使 用 LIMIT 修饰 符 限制 返回 结果 


排序 之 后 返回 元 素 的 数量 可 以 通过 LIMIT 修饰 符 进 行 限制 ， 修饰 符 接受 
offset 和 count 两 个 参数 : 


e offset 指定 要 跳 过 的 元 素数 量 。 
e count 指定 跳 过 offset 个 指定 的 元 素 之 后 ， 要 返回 多 少 个 对 象 。 


以 下 例子 返回 排序 结果 的 前 5 个 对 象 ( offset 为 0 表示 没有 元 素 被 跳 过 )。 


# 添加 测试 数据 ， 列 表 值 为 1 指 10 


redis 127.0.0.1:6379> RPUSH rank 1357 9 
(integer) 5 


redis 127.0.0.1:6379> RPUSH rank 2 4 6 8 10 
(integer) 10 


# 返回 列表 中 最 小 的 5 Ma 


redis 127.0.0.1:6379> SORT rank LIMIT 0 5 


1) egen 
2) WRN 
3) SN 
4) AN 
5) Upu 


可 以 组 合 使 用 多 个 修饰 符 。 以 下 例子 返回 从 大 到 小 排序 的 前 5 个 对 象 。 


redis 127.0.0.1:6379> SORT rank LIMIT © 5 DESC 


1) "10" 
2) wom 
3) WRU 
4) ivan 
5) neu 


使 用 外 部 key 进行 排序 


可 以 使 用 外 部 key 的 数据 作为 权重 ， 代 蔡 黑 认 的 直接 对 比 键 值 的 方式 来 进行 排 
序 。 


假设 现在 有 用 户 数据 如 下 : 


uid username{uid} userlevel{uid} 
1 admin 9999 
2 jack 10 
3 peter 25 
4 mary 70 


以 下 代码 将 数据 输入 到 Redis 中 : 


# admin 


redis 127.0.0.1:6379> LPUSH uid 1 
(integer) 1 


redis 127.0.0.1:6379> SET user_name_1 admin 
OK 


redis 127.0.0.1:6379> SET user_level_1 9999 
OK 


# jack 


redis 127.0.0.1:6379> LPUSH uid 2 
(integer) 2 


redis 127.0.0.1:6379> SET user_name_2 jack 
OK 


redis 127.0.0.1:6379> SET user_level_2 10 
OK 


# peter 


redis 127.0.0.1:6379> LPUSH uid 3 
(integer) 3 


redis 127.0.0.1:6379> SET user_name_3 peter 
OK 


redis 127.0.0.1:6379> SET user_level_3 25 
OK 


# mary 


redis 127.0.0.1:6379> LPUSH uid 4 
(integer) 4 


redis 127.0.0.1:6379> SET user_name_4 mary 
OK 


redis 127.0.0.1:6379> SET user_level_4 70 
OK 


BY 选项 
默认 情况 下 ， SORT uid 直接 按 uid 中 的 值 排序 : 


redis 127.0.0.1:6379> SORT uid 


de) beet # admin 
2 Va # jack 
G 各- # peter 
4) "4" # mary 


通过 使 用 BY 选项 ， 可 以 让 uid 按 其 他 键 的 元 素来 排序 。 
比如 说 ， 以 下 代码 让 uid 键 按照 user_level {uid} 的 大 小 来 排序 : 


redis 127.0.0.1:6379> SORT uid BY user_level_* 


ls 2 # jack , level = 10 
2 euro # peter, level = 25 
3) "4" # mary, level = 70 
Za Ee # admin, level = 9999 


user_level * 是 一 个 占 位 符 ， 它 先 取出 uid 中 的 值 ， 然后 再 用 这 个 值 来 查 
找 相应 的 键 。 


比如 在 对 uid 列表 进行 排序 时 ， 程序 就 会 先 取出 uid 的 值 1 、 2 、 3 
4 ， 然后 使 用 user level 1 、 user level 2 、 user level 3 和 
user_level_ 4 的 值 作 为 排序 uid 的 权重 。 


GET 选项 
使 用 GET 选项 ， 可 以 根据 排序 的 结果 来 取出 相应 的 键 值 。 
比如 说 ， 以 下 代码 先 排序 uid ， 再 取出 键 user_name_{uid} 的 值 : 


redis 127.0.0.1:6379> SORT uid GET user_name_* 


1) "admin" 
2) "jack" 
3) "peter" 
4) "mary" 


组 合 使 用 BY 和 GET 
通过 组 合 使 用 BY 和 GET ， 可 以 让 排序 结果 以 更 直观 的 方式 显示 出 来 。 


比如 说 ， 以 下 代码 先 按 user_level_{uid} 来 排序 uid 列表 ， 再 取出 相应 的 
user_name_{uid} 的 值 : 


redis 127.0.0.1:6379> SORT uid BY user_level_* GET user_name_* 


1) "jack" # level = 10 
2) "peter" # level = 25 
3) "mary" # level = 70 
4) "admin" # level = 9999 


现在 的 排序 结果 要 比 只 使 用 SORT uid BY user_level * 要 直观 得 多 。 


获取 多 个 外 部 键 
可 以 同时 使 用 多 个 GET 选项 ， 获取 多 个 外 部 键 的 值 。 
以 下 代码 就 按 uid 分 别 获 取 user_level_{uid} 和 user_name_{uid} 


redis 127.0.0.1:6379> SORT uid GET User level * GET user_name_* 


1) "9999" # level 
2) "admin" # name 
3) "10" 

4) "jack" 

5) "25" 

6) "peter" 

7) "70" 

8) "mary" 





GET 有 一 个 额外 的 参数 规则 ， 那 就 是 可 以 用 # 获取 被 排序 键 的 值 。 


以 下 代码 就 将 uid 的 值 、 及 其 相应 的 user_level_* 和 user_name_* 都 返 
回 为 结果 : 


redis 127.0.0.1:6379> SORT uid GET # GET user_level_* GET user_name 


dey Hany # uid 
2) "9999" # level 
3) "admin" # name 
4) Wie 

5) "10" 

6) Mack" 

7) MESU 

8) "25" 

9) "peter" 

10) LAU 

T1070 

12) "mary" 





获取 外 部 键 ， 但 不 进行 排序 


通过 将 一 个 不 存在 的 键 作为 参数 传 给 BY 选项 ， 可 以 让 sort 跳 过 排序 操作 ， 
直接 返回 结果 : 


redis 127.0.0.1:6379> SORT uid BY not-exists-key 


1) oA 
2) Weer 
3) Wie 
4) Wey 


这 种 用 法 在 单独 使 用 时 ， 没 什么 实际 用 处 。 


不 过 ， 通 过 将 这 种 用 法 和 GET 选项 配合 ， 就 可 以 在 不 排序 的 情况 下 ， 获取 多 个 
外 部 键 ， 相当 于 执行 一 个 整合 的 获取 操作 (类 似 于 SQL 数据 库 的 join 关键 
F) 

以 下 代码 演示 了 ， 如 何在 不 引起 排序 的 情况 下 ， 使 用 SORT. BY 和 GET # 
取 多 个 外 部 键 : 


redis 127.0.0.1:6379> SORT uid BY not-exists-key GET # GET user_le\ 
IDA # id 


2) "70" # level 
3) "mary" # name 
4) Wau 

5) "25" 

6) "peter" 

7) Uo ih 

8) "10" 

9) "jack" 

10) Ue aN 

11) "9999" 

12) "admin" 





将 哈 希 表 作为 GET 或 BY 的 参数 
除了 可 以 将 字符 串 键 之 外 ， 哈 希 表 也 可 以 作为 GET 或 BY 选项 的 参数 来 使 用 。 
比如 说 ， 对 于 前 面 给 出 的 用 户 信息 表 : 


uid username{uid} userlevel{uid} 
1 admin 9999 
2 jack 10 
3 peter 25 
4 mary 70 


我 们 可 以 不 将 用 户 的 名 字 和 级 别 保存 在 user_name_{uid} 和 
user_level {uid} 两 个 字符 串 键 中 ， 而 是 用 一 个 带 有 name A level 域 
的 哈 希 表 user_info_{uid} 来 保存 用 户 的 名 字 和 级 别 信息 : 


redis 127.0.0.1:6379> HMSET user_info_1 name admin level 9999 
OK 


redis 127.0.0.1:6379> HMSET user_info_2 name jack level 10 
OK 


redis 127.0.0.1:6379> HMSET user_info_3 name peter level 25 
OK 


redis 127.0.0.1:6379> HMSET user_info_4 name mary level 70 
OK 


之 后 ， BY 和 GET 选项 都 可 以 用 key-&gt;field 的 格式 来 获取 哈 希 表 中 的 
域 的 值 ， 其 中 key 表示 哈 希 表 键 ， 而 field 则 表示 哈 希 表 的 域 : 


redis 127.0.0.1:6379> SORT uid BY user_info_*->level 


1) Wie 

2) MEZ 

3) WAN 

4) We Ee 

redis 127.0.0.1:6379> SORT uid BY user_info_*->level GET user_info. 
1) "jack" 

2) "peter" 

3) "mary" 

4) "admin" 





保存 排序 结果 

默认 情况 下 ， SORT 操作 只 是 简单 地 返回 排序 结果 ， 并 不 进行 任何 保存 操作 。 
通过 给 STORE 选项 指定 一 个 key 参数， 可 以 将 排序 结果 保存 到 给 定 的 键 上 。 
如 果 被 指定 的 key 已 存在 ， 那 么 原 有 的 值 将 被 排序 结果 覆盖 。 


# 测试 数据 


redis 127.0.0.1:6379> RPUSH numbers 1 3 5 7 9 
(integer) 5 


redis 127.0.0.1:6379> RPUSH numbers 2 4 6 8 10 
(integer) 10 


redis 127.0.0.1:6379> LRANGE numbers © -1 


1) Wa 
2) EZM 
3) UEU 
4) Wr Al 
5) wou 
6) ERN 
7) VUAN 
8) We" 
9) Urey 
10) "10" 


redis 127.0.0.1:6379> SORT numbers STORE sorted-numbers 
(integer) 10 


# 排序 后 的 结果 


redis 127.0.0.1:6379> LRANGE sorted-numbers 0 -1 


1) veen 
2) NA 
3) MSU 
4) wA 
5) Up 
6) "6" 
7) We 
8) WOU 
9) wou 
10) "10" 


可 以 通过 将 SORT 命令 的 执行 结果 保存 ， 并 用 EXPIRE 为 结果 设置 生存 时 间 ， 以 
此 来 产生 一 个 SORT 操 作 的 结果 缓存 。 


这 样 就 可 以 避免 对 SORT 操作 的 频繁 调用 : 只 有 当 结 果 集 过 期 时 ， 才 需要 再 调用 一 
次 SORT 操作 。 


另外 ， 为 了 正确 实现 这 一 用 法 ， 你 可 能 需要 加 锁 以 避免 多 个 客户 端 同时 进行 缓存 重 
建 (也 就 是 多 个 客户 端 ， 同一 时 间 进 #47 SORT 操作 ， 并 保存 为 结果 集 )， 具 体 参 见 
SETNX 命令。 


可 用 版 本 : 
>= 1.0.0 


时 间 复 杂 度 : 


O(N+M*log(M)), AN 为 要 排序 的 列表 或 集合 内 的 元 素数 量 ， M 为 要 返回 的 元 素 
数量 。 如 果 只 是 使 用 SORT 命令 的 GET 选项 获取 数据 而 没有 进行 排序 ， 时 间 复 
条 度 O(N)。 


返回 值 : 


没有 使 用 STORE 参数， 返回 列表 形式 的 排序 结果 。 使 用 STORE 参数， 返回 排 
序 结果 的 元 素数 量 。 


TTL 


TTL key 

以 秒 为 单位 ， 返 回 给 定 key 的 剩余 生存 时 间 (TTL, time to live), 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 


当 key 不 存在 时 ， 返 回 -2 。 当 key 存在 但 没有 设置 剩余 生存 时 间 时 ， 返 回 
-1 。 人 否则 ， 以 秒 为 单位 ， 返 回 key 的 剩余 生存 时 间 。 


Note 


在 Redis 2.8 以 前 ， 当 key AE, RA key 没有 设置 剩余 生存 时 间 时 ， 命 兮 
都 返回 -1 。 


# 不 存在 的 key 


redis> FLUSHDB 
OK 


redis> TTL key 
(integer) -2 


# key 存在 ， 但 没有 设置 剩余 生存 时 间 


redis> SET key value 
OK 


redis> TTL key 
(integer) -1 


# BRREGH AN key 


redis> EXPIRE key 10086 
(integer) 1 


redis> TTL key 
(integer) 10084 


TYPE 


TYPE key 
返回 key 所 储存 的 值 的 类 型 。 
可 用 版 本 : 
>= 1.0.0 
Bt a] RAE: 
O(1) 
返回 值 : 
none (key 不 存在 ) string (字符 串 ) list (列表 ) set (集合 ) zset (有 序 
集 ) hash ( 哈 希 表 ) 
# 字符 串 


redis> SET weather "sunny" 
OK 


redis> TYPE weather 
string 


# 列表 


redis> LPUSH book_list "programming in scala" 
(integer) 1 


redis> TYPE book_list 
list 


# 集合 


redis> SADD pat "dog" 
(integer) 1 


redis> TYPE pat 
set 


SCAN 


SCAN cursor [MATCH pattern] [COUNT count] 


SCAN 命令 及 其 相关 的 SSCAN AD, HSCAN 命令 和 ZSCAN 命令 都 用 于 增 量 地 
迭代 (incrementally iterate) 一 集 元 素 (a collection of elements) 


SCAN 命 舍 用 于 迭代 当前 数据 库 中 的 数据 库 键 。 

SSCAN 命令 用 于 迭代 集合 键 中 的 元 素 。 

HSCAN 命令 用 于 迭代 哈 希 键 中 的 键 值 对 。 

ZSCAN 命令 用 于 迭代 有 序 集合 中 的 元 素 (包括 元 素 成 员 和 元 素 分 值 ) o 


以 上 列 出 的 四 个 命令 都 支持 增 量 式 迭代 ， 它们 每 次 执行 都 只 会 返回 少量 元 素 ， 所 
以 这 些 命令 可 以 用 于 生产 环境 ， 而 不 会 出 现 像 KEYS 命令 、SMEMBERS 命令 带 
来 的 问题 当 KEYS 命令 被 用 于 义理 一 个 大 的 数据 库 时 ， 又 或 者 SMEMBERS 
命 命 被 用 于 处理 一 个 大 的 集合 键 时 ， 它们 可 能 会 阻塞 服务 器 达 数 秒 之 久 。 


不 过 ， 增 量 式 迭 代 命 合 也 不 是 没有 缺点 的 : 举 个 例子 ， 使 用 SMEMBERS 命令 
以 返回 集合 键 当前 包含 的 所 有 元 素 ， 但 是 对 于 SCAN 这 类 增 量 式 迭 代 命令 来 说 ， 
因为 在 对 键 进行 增 量 式 和 迭代 的 过 程 中 ， 键 可 能 会 被 修改 ， 所 以 增 量 式 迭 代 命 全 只 
能 对 被 返回 的 元 素 提供 有 限 的 保证 (offer limited guarantees about the returned 
elements) 。 


% SCAN, SSCAN, HSCAN 和 ZSCAN 四 个 命令 的 工作 方式 都 非常 相似 ， 
所 以 这 个 文档 会 一 并 介绍 这 四 个 命令 ， 但 是 要 记 住 : 


e SSCAN #843, HSCAN 命令 和 ZSCAN 命令 的 第 一 个 参数 总 是 一 个 数据 库 
键 。 

e 而 SCAN 命令 则 不 需要 在 第 一 个 参数 提供 任何 数据 库 键 一 一 因为 它 迭 代 的 是 
当前 数据 库 中 的 所 有 数据 库 键 。 


SCAN 命令 的 基本 用 法 


SCAN 命令 是 一 个 基于 游标 的 迭代 器 (cursor based iterator) : SCAN 命 命 每 次 
被 调用 之 后 ， 都 会 向 用 户 返 回 一 个 新 的 游标 ， 用 户 在 下 次 迭代 时 需要 使 用 这 个 新 
游标 作为 SCAN 命令 的 游标 参数 ， 以 此 来 延续 之 前 的 迭代 过 程 。 


当 SCAN 命令 的 游标 参数 被 设置 为 © nt, 服务 器 将 开始 一 次 新 的 迭代 ， 而 当 服 
务 器 向 用 户 返 回 值 为 0 的 游标 时 ， 表示 迭代 已 结束 。 


以 下 是 一 个 SCAN 命令 的 迭代 过 程 示例 : 





redis 127.0.0.1:6379> scan 0 


1) We) TAN 
2) 1) "key:12" 
2) "key:8" 
3) "key:4" 
4) "key:14" 
5) "key:16" 
6) "key:17" 
7) "key:15" 
8) "key:10" 
9) "key:3" 
10) "key:7" 
11) "key:1" 
redis 127.0.0.1:6379> scan 17 
1) We" 
2) 1) “key:5" 
2) "key:18" 
3) "key:0" 
4) "key:2" 
5) "key:19" 
6) "key:13" 
7) "key:6" 
8) "key:9" 
9) "key:11" 


在 上 面 这 个 例子 中 ， 第 一 次 迭代 使 用 6 作为 游标 ， ROA RMA, 


第 二 次 迭代 使 用 的 是 第 一 次 迭代 时 返回 的 游标 ， 也 即 是 命令 回复 第 一 个 元 素 的 值 
— p. 


从 上 面 的 示例 可 以 看 到 ， SCAN 命令 的 回复 是 一 个 包含 两 个 元 素 的 数组 ， 第 一 个 
Ba TTA THT ROR as, 而 第 二 个 数组 元 素 则 是 一 个 数组 ， 这 
个 数组 中 包含 了 所 有 被 迭代 的 元 素 。 


在 第 二 次 调用 SCAN 命令 时 ， 命令 返回 了 游标 9 ， 这 表示 迭代 已 经 结束 ， 整个 
数据 集 (collection) 已 经 被 完整 通 历 过 了 。 


以 o 作为 游标 开始 一 次 新 的 迭代 ， 一 直 调 用 SCAN AD, 直到 命令 返回 游标 
9 ， 我 们 称 这 个 过 程 为 一 次 完整 表 历 (full iteration) 。 


SCAN MEERE (guarantees) 


SCAN 命 售 ， 以 及 其 他 增 量 式 迭 代 命 仿 ， Ee Tse AE AAAA A Pa 
来 以 下 保证 : Mace AA BER, 一 直 存 在 于 数据 集 内 的 所 
有 元 素 都 会 被 完整 通 历 返回 ; 这 意味 着 ， 如 果 有 一 个 元 素 ， EMEA FAE EE 
历 结束 期 间 都 存在 于 被 通 历 的 数据 集 当 中 ， 那么 SCAN 命令 总 会 在 录 次 迭代 中 将 
这 个 元 素 返回 给 用 户 。 


然而 因为 增 量 式 命令 仅仅 使 用 游标 来 记录 和 迭代 状态 ， 所 以 这 些 命令 带 有 以 下 缺点 : 


。 同一 个 元 素 可 能 会 被 返回 多 次 。 义理 重复 元 素 的 工作 交 由 应 用 程序 负责 ， 比 
如 说 ， 可 以 考虑 煌 迭代 返回 的 元 素 仅仅 用 于 可 以 安全 地 重复 执行 多 次 的 操作 


Es 

。 如 果 一 个 元 素 是 在 迭代 过 程 中 被 添加 到 数据 集 的 ， 又 或 者 是 在 迁 代 过 程 中 从 数 
那么 这 个 元 素 可 能 会 被 返回 也 可 能 不 会 ， 这 是 未 定义 的 
undefined) 。 


SCAN 命 今 每 次 执行 返回 的 元 素数 量 


迭代 命令 并 不 保证 每 次 执行 都 返回 某 个 给 定数 量 的 元 素 。 

增 其 至 可 能 会 返回 替 个 元 素 ， 但 只 要 命 合 返回 的 游标 不 是 0, 应 用 程 
序 就 不 应 该 将 迭代 视 作 结束 。 

不 过 命令 返回 的 元 素数 量 总 是 符合 一 定 规则 的 ， 在 实际 中 : 

e 对 于 一 个 大 数据 集 来 说 ， 增 量 式 迭 代 命 命 每 次 最 多 可 能 会 返回 数 十 个 元 素 ; 

e。 而 对 于 一 个 足够 小 的 数据 集 来 说 ， 如 果 这 个 数据 集 的 底层 表示 为 编码 数据 结 
(encoded data structure， 适 用 于 是 小 集合 键 、 人 
那么 增 量 迭代 命令 将 在 一 次 调用 中 返回 数据 集中 的 所 有 元 素 。 

min, 用 户 可 以 通过 增 量 式 迭 代 命 合 提 供 的 COUNT 选项 来 指定 每 次 迭代 返回 元 
素 的 最 大 值 。 


E hajo 
SH H 
er BD be 
op 


COUNT 选项 


$ a Nene D TERERAA RREI TRAE, 但 我 们 可 以 使 用 COUNT 
选项 ， 对 命令 的 行为 进行 一 定 程度 上 的 调整 


HAL, COUNT 选项 的 作用 束 是 让 用 户 告知 迭代 命令 ， 在 每 次 迭代 中 应 该 从 数 
据 集 里 返回 多 少 元 素 。 


虽然 COUNT 选项 只 是 对 增 量 式 迭 代 命 合 的 一 种 提示 (hint) ， 但 是 在 大 多 数 情 况 
下 ， 这 种 提示 都 是 有 效 的 。 


e COUNT 参数 的 默认 值 为 10 o 

e 在 迭代 一 个 足够 大 的 、 由 哈 希 表 实 现 的 数据 库 、 集 合 键 、 哈 希 键 或 者 有 序 集合 
键 时 ， 如 果 用 户 没 有 使 用 MATCH 选项 ， 那么 命令 返回 的 元 素数 量 通 常 和 
COUNT 选项 指定 的 一 样 ， 或 者 比 ”COUNT 选项 指定 的 数量 稍 多 一 些 。 

。 在 迭代 一 个 编码 为 整数 集合 (intset， 一 个 只 由 整数 值 构 成 的 小 集合 ) 、 或 者 
编码 为 压缩 列表 (ziplist， 由 不 同和 值 构成 的 一 个 小 哈 希 或 者 一 个 小 有 序 集合 ) 
时 ， 增 量 式 迭 代 命 合 通 常会 无 视 COUNT 选项 指定 的 值 ， 在 第 一 次 迭代 就 将 
数据 集 包 含 的 所 有 元 素 都 返回 给 用 户 。 


Note 


并 非 每 次 迭代 都 要 使 用 相同 的 COUNT 值 。 


用 户 可 以 在 每 次 迭代 中 按 自己 的 需要 随意 改变 COUNT ff, 只 要 记得 将 上 次 进 代 
返回 的 游标 用 到 下 次 迭代 里 面 就 可 以 了 。 


MATCH 选项 


和 KEYS 命令 一 样 ， 增 量 式 迭 代 命令 也 可 以 通过 提供 一 个 glob 风格 的 模式 参数 ， 
让 命令 只 返回 和 给 定 模 式 相 匹配 的 元 素 ， 这 一 点 可 以 通过 在 执行 增 量 式 迭代 命 兮 


at, 通过 给 定 MATCH &lt;pattern&gt; 参数 来 实现 。 


以 下 是 一 个 使 用 MATCH 选项 进行 迭代 的 示例 : 


redis 127.0.0.1:6379> sadd myset 1 2 3 foo foobar feelsgood 
(integer) 6 


redis 127.0.0.1:6379> sscan myset © match f* 


1) "o" 

2) 1) "foo" 
2) "feelsgood" 
3) "foobar" 


需要 注意 的 是 ， 对 元 素 的 模式 匹配 工作 是 在 命令 从 数据 集中 取出 元 素 之 后 ， AB 
户 端 返回 元 素 之 前 的 这 段 时 间 内 进行 的 ， 所 以 如 果 被 迭代 的 数据 集中 只 有 少量 元 素 
和 模式 相 匹 配 ， 那么 迭代 命 合 或 许 会 在 多 次 执行 中 都 不 返回 任何 元 素 。 


以 下 是 这 种 情况 的 一 个 例子 : 


redis 127.0.0.1:6379> scan © MATCH *11* 
1) W288 
2) 1) “key: 910" 


redis 127.0.0.1:6379> scan 288 MATCH *11* 
19224 
2) (empty list or set) 


redis 127.0.0.1:6379> scan 224 MATCH *11* 
1) "30" 
2) (empty list or set) 


redis 127.0.0.1:6379> scan 80 MATCH *11* 
A TAS 
2) (empty list or set) 


redis 127.0.0.1:6379> scan 176 MATCH *11* COUNT 1000 


1) "o" 

2) 1) "key:611" 
2) "key:711" 
3) "key:118" 
4) "key:117" 
5) "key:311" 
6) "key:112" 
7) "key:111" 
8) "key:110" 
9) "key:113" 


10) "key:211" 
11) "key:411" 
12) "key:115" 
13) "key:116" 
14) "key:114" 
15) "key:119" 
16) "key:811" 
17) "key:511" 
18) "key:11" 


如 你 所 见 ， 以 上 的 大 部 分 迭代 都 不 返回 任何 元 素 。 

在 最 后 一 次 迭代 ， 我 们 通过 将 COUNT 选项 的 参数 设置 为 1000 ， 强制 命令 为 
本 次 迭代 扫描 更 多 元 素 ， 从 而 使 得 命令 返回 的 元 素 也 变 多 了 。 

并 发 执行 多 个 迭代 

在 同一 时 间 ， 可 以 有 任意 多 个 客户 端 对 同一 数据 集 进 行 迭 代 ， 客户 端 每 次 执行 迭 


代 都 需要 传人 一 个 游标 ， 并 在 迭代 执行 之 后 获得 一 个 新 的 游标 ， 而 这 个 游标 就 包 
含 了 迭代 的 所 有 状态 ， 因此 ， 服务 器 无 须 为 迭代 记录 任何 状态 。 


中 途 停止 迭代 

因为 途 代 的 所 有 状态 都 保存 在 游标 里 面 ， 而 服务 器 无 须 为 迭代 保存 任何 状态 ， 所 
以 客户 端 可 以 在 中 途 停止 一 个 欠 代 ， 而 无 须 对 服务 器 进行 任何 通知 。 

即使 有 任意 数量 的 迭代 在 中 途 停止 ， 也 不 会 产生 任何 问题 。 


使 用 错误 的 游标 进行 增 量 式 迭 代 


使 用 间断 的 (broken) 、 负 数 、 超 出 范围 或 者 其 他 非 正常 的 游标 来 执行 增 量 式 和 迭代 
并 不 会 造成 服务 器 崩溃 ， 但 可 能 会 让 命令 产生 未 定义 的 行为 。 


未 定义 行为 指 的 是 ， 增 量 式 命 合 对 返回 值 所 做 的 保证 可 能 会 不 再 为 真 。 
只 有 两 种 游标 是 合法 的 : 


1. 在 开始 一 个 新 的 迭代 时 ， 游标 必须 为 0 。 
2. 增 量 式 迭 代 命 合 在 执行 之 后 返回 的 ， 用 于 延续 (continue) 迭代 过 程 的 游标 。 


增 量 式 迭 代 命 舍 所 使 用 的 算法 只 保证 在 数据 集 的 大 小 有 界 (bounded) 的 情况 下 ， 
迭代 才 会 停止 ， 换 句 话说 ， 如 果 被 迭代 数据 集 的 大 小 不 断 地 增长 的 话 ， Tere 
代 命令 可 能 永远 也 无 法 完成 一 次 完整 迭代 。 


从 直觉 上 可 以 看 出 ， 当 一 个 数据 集 不 断 地 变 大 时 ， 想 要 访问 这 个 数据 集中 的 所 有 
元 素 就 需要 做 越 来 越 多 的 工作 ， 能 否 结束 一 个 迭代 取决 于 用 户 执行 迭代 的 速度 是 否 
比 数 据 集 增 长 的 速度 更 快 。 


可 用 版 本 : 
> >= 2.8.0 
时 间 复 条 度 : 


> 增 量 式 迭 代 命 命 每 次 执行 的 复杂 度 为 O(1) ， 对 数据 集 进行 一 次 完整 迭代 的 复杂 
度 为 O(N) ， 其 中 N 为 数据 集中 的 元 素数 量 。 


返回 值 : 


> SCAN 84. SSCAN #84. HSCAN 484541 ZSCAN 命令 都 返回 一 个 包含 两 个 
元 素 的 multi-bulk 回复 : 回复 的 第 一 个 元 素 是 字符 串 表示 的 无 符号 64 位 整数 ( 游 
标 ) ， 回复 的 第 二 个 元 素 是 另 一 个 multi-bulk 回复 ， 这 个 multi-bulk 回复 包含 了 本 
次 被 迭代 的 元 素 。 > > SCAN 命令 返回 的 每 个 元 素 都 是 一 个 数据 库 键 。 > > 
SSCAN 命令 返回 的 每 个 元 素 都 是 一 个 集合 成 员 。 > > HSCAN 命令 返回 的 每 个 元 
素 都 是 一 个 键 值 对 ， 一 个 键 值 对 由 一 个 键 和 一 个 值 组 成 。 > > ZSCAN 命令 返回 的 
每 个 元 素 都 是 一 个 有 序 集 合 元 素 ， 一 个 有 序 集 合 元 素 由 一 个 成 员 (member) 和 一 
个 分 值 (score) 组 成 。 


String (FFE) 


APPEND 


APPEND key value 


如 果 key 已 经 存在 并 且 是 一 个 字符 串 ， APPEND 命令 将 value 追加 到 key 
原来 的 值 的 末尾 。 


如 果 key 不 存在 ， APPEND 就 简单 地 将 给 定 key 设 为 value ， 就 像 执行 
SET key value 一 样 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

平 挫 O(1) 

WIE) {a : 

追加 value 之 后 ， key 中 字符 串 的 长 度 。 


# 对 不 存在 的 key 执行 APPEND 


redis> EXISTS myphone # 确保 myphone 不 存在 

(integer) 0 

redis> APPEND myphone "nokia" # 对 不 存在 的 key 进行 APPEND ， 等 | 
(integer) 5 # FHKE 


# 对 已 存在 的 字符 串 进行 APPEND 


redis> APPEND myphone " - 1110" # KEM 5 个 字符 增加 到 12 个 字符 
(integer) 12 


redis> GET myphone 
"nokia - 1110" 


4 mon 





模式 : 时 间 序 列 (Time series) 


APPEND 可 以 为 一 系列 定 长 (fixed-size) 数 据 (sample) 提 供 一 种 紧凑 的 表示 方式 ， 通 
常 称 之 为 时 间 序 列 。 


每 当 一 个 新 数据 到 达 的 时 候 ， 执 行 以 下 命令 : 


APPEND timeseries "fixed-size sample" 


然后 可 以 通过 以 下 的 方式 访问 时 间 序列 的 各 项 属性 : 


e STRLEN 给 出 时 间 序 列 中 数据 的 数量 

e GETRANGE 可 以 用 于 随机 访问 。 只 要 有 相关 的 时 间 信 息 的 话 ， 我 们 就 可 以 在 
Redis 2.6 中 使 用 Lua 脚本 和 GETRANGE 命令 实现 二 分 查找 。 

e SETRANGE 可 以 用 于 覆盖 或 修改 已 存在 的 的 时 间 序 列 。 


这 个 模式 的 唯一 缺陷 是 我 们 只 能 增长 时 间 序 列 ， 而 不 能 对 时 间 序 列 进行 缩短 ， 因 为 
Redis 目前 还 没有 对 字符 串 进 行 修剪 (tirm) 的 命令 ， 但 是 ， 不 管 怎么 说 ， 这 个 模式 的 
储存 方式 还 是 可 以 节省 下 大 量 的 空间 。 

Note 

可 以 考虑 使 用 UNIX 时 间 戳 作为 时 间 序 列 的 键 名 ， 这 样 一 来 ， 可 以 避免 单个 key 

因为 保存 过 大 的 时 间 序 列 而 占用 大 量 内 存 ， 另 一 方面 ， 也 可 以 节省 下 大 量 命名 空 

间 o 


下 面 是 一 个 时 间 序 列 的 例子 : 
redis> APPEND ts "0043" 
(integer) 4 


redis> APPEND ts "0035" 
(integer) 8 


redis> GETRANGE ts 0 3 
"0043" 


redis> GETRANGE ts 4 7 
"90035" 


BITCOUNT 


BITCOUNT key [start] [end] 
计算 给 定 字符 串 中 ， 被 设置 为 1 的 比特 位 的 数量 。 


一 般 情况 下 ， 给 定 的 整个 字符 串 都 会 被 进行 计数 ， 通 过 指定 额外 的 start 或 
end 参数 ， 可 以 让 计数 只 在 特定 的 位 上 进行 。 


start 和 end 参数 的 设置 和 GETRANGE 命 命 类似， 都 可 以 使 用 负数 值 : 比 
如 -1 表示 最 后 一 个 字 节 ， -2 表示 倒数 第 二 个 字 节 ， 以 此 类 推 。 


不 存在 的 key 被 当成 是 空 字符 串 来 处 理 ， 因 此 对 一 个 不 存在 的 key 进行 
BITCOUNT 操作， 结果 为 © 。 


可 用 版 本 : 

>= 2.6.0 

时 间 复 杂 度 : 

O(N) 

返回 值 : 

被 设置 为 1 的 位 的 数量 。 
redis> BITCOUNT bits 
(integer) 0 


redis> SETBIT bits 0 1 # 0001 
(integer) 0 


redis> BITCOUNT bits 
(integer) 1 


redis> SETBIT bits 3 1 # 1001 
(integer) 0 


redis> BITCOUNT bits 
(integer) 2 


模式 : 使 用 bitmap 实现 用 户 上 线 次 数 统计 


Bitmap 对 于 一 些 特 定 类 型 的 计算 非常 有 效 。 


假设 现在 我 们 希望 记录 自己 网 站 上 的 用 户 的 上 线 频 率 ， 比 如 说 ， 计 算 用 户 A 上 线 了 
多 少 天 ， 用 户 B 上 线 了 多 少 天 ， 诸 如 此 类 ， 以 此 作为 数据 ， 从 而 决定 让 哪些 用 户 参 
加 beta 测试 等 活动 一 一 这 个 模式 可 以 使 用 SETB/T 和 BITCOUNT 来 实现 。 


比如 说 ， 每 当 用 户 在 某 一 天 上 线 的 时 候 ， 我 们 就 使 用 SETB/ 厂 ， 以 用 户 名 作为 
key ， 将 那天 所 代表 的 网 站 的 上 线 日 作为 offset 参数， 并 将 这 个 ”offset 
上 的 为 设置 为 1 。 


举 个 例子 ， 如 果 今 天 是 网 站 上 线 的 第 100 天 ， 而 用 户 pete 在 今天 阅览 过 网 站 ， 那 
人 么 执行 命令 SETBIT peter 100 1 ; 如 果 明 天 peter 也 继续 阅览 网 站 ， 那 么 执行 
命令 SETBIT peter 101 1 ， 以 此 类 推 。 


当 要 计算 peter 总 共 以 来 的 上 线 次 数 时 ， 就 使 用 BITCOUNT 命令 : 执行 
BITCOUNT peter ， 得 出 的 结果 就 是 peter 上 线 的 总 天 数 。 


更 详细 的 实现 可 以 参考 博文 ( 墙 外 ) Fast, easy, realtime metrics using Redis bitmaps 


o 


性 能 


前 面 的 上 线 次 数 统计 例子 ， 即 使 运行 10 年 ， 占 用 的 空间 也 只 是 每 个 用 户 10*365 比 
特 位 (bit)， 也 即 是 每 个 用 户 456 字 节 。 对 于 这 种 大 小 的 数据 来 说 ， BITCOUNT 的 
义理 速度 就 像 GETT INCR 这 种 O(1) 复 条 度 的 操作 一 样 快 。 


如 果 你 的 bitmap 数据 非常 大 ， 那 么 可 以 考虑 使 用 以 下 两 种 方法 : 


1. 将 一 个 大 的 bitmap 分 散 到 不 同 的 key 中 ， 作 为 小 的 bitmap 来 人 处理。 使 用 Lua 
脚本 可 以 很 方便 地 完成 这 一 工作 。 

2. 使 用 BITCOUNT 的 start 和 end 参数 ， 每 次 只 对 所 需 的 部 分 位 进行 计 
算 ， 将 位 的 累积 工作 (accumulating) 放 到 客户 端 进 行 ， 并 且 对 结果 进行 缓存 
(caching)。 


BITOP 


BITOP operation destkey key [key ...] 


对 一 个 或 多 个 保存 二 进 制 位 的 字符 串 key 进行 位 元 操作 ， 并 将 结果 保存 到 
destkey 上 。 


operation 可 以 是 AND 、 OR. NOT 、 XOR 这 四 种 操作 中 的 任意 一 
种 : 


èe BITOP AND destkey key [key ...] ， 对 一 个 或 多 个 key 求 逻 辑 并 ， 并 
将 结果 保存 到 destkey 。 

e BITOP OR destkey key [key ...] ， 对 一 个 或 多 个 key 求 逻 辑 或 ， 并 
将 结果 保存 到 destkey 。 

èe BITOP XOR destkey key [key ...] ， 对 一 个 或 多 个 key RZ HRX, 
并 将 结果 保存 到 destkey 。 

e BITOP NOT destkey key ， 对 给 定 key 求 逮 辑 非 ， 并 将 结果 保存 到 


destkey œ% 
除了 NOT 操作 之 外 ， 其 他 操作 都 可 以 接受 一 个 或 多 个 key 作为 输入 。 
处 理 不 同 长 度 的 字符 串 


当 BITOP 你 理 不 同 长 度 的 字符 串 时 ， 较 短 的 那个 字符 串 所 缺少 的 部 分 会 被 看 作 
0 o 


空 的 key 也 被 看 作 是 包含 0 的 字符 串 序 列 。 

可 用 版 本 : 

>= 2.6.0 

时 间 复 条 度 : 

O(N) 

Wl) 4a : 

保存 到 destkey 的 字符 串 的 长 度 ， 和 输入 key 中 最 长 的 字符 串 长 度 相 等 。 
Note 


BITOP 的 复 条 度 为 O(N) ， 当 义理 大 型 矩阵 (matrix) 或 者 进行 大 数据 量 的 统计 时 ， 最 
好 将 任务 指派 到 附属 节点 (slave) 进 行 ， 避 免 阻 塞 主 节 点 。 


redis> SETBIT bits-1 0 1 # bits-1 = 1001 
(integer) 0 


redis> SETBIT bits-1 3 1 
(integer) 0 


redis> SETBIT bits-2 0 1 # bits-2 = 1011 
(integer) 0 


redis> SETBIT bits-2 1 1 
(integer) 0 


redis> SETBIT bits-2 3 1 
(integer) 0 


redis> BITOP AND and-result bits-1 bits-2 
(integer) 1 


redis> GETBIT and-result 0 # and-result = 1001 
(integer) 1 


redis> GETBIT and-result 1 
(integer) 0 


redis> GETBIT and-result 2 
(integer) 0 


redis> GETBIT and-result 3 
(integer) 1 


DECR 


DECR key 
key 中 储存 的 数字 值 减 一 。 


如 果 key 不 存在 ， 那 么 key 的 值 会 先 被 初始 化 为 ”9 ， 然 后 再 执行 DECR 操 
作 。 


如 果 值 包含 错误 的 类 型 ， 或 字符 串 类 型 的 值 不 能 表示 为 数字 ， 那 么 返回 一 个 错误 。 
本 操作 的 值 限制 在 64 位 (bit) 有 符号 数字 表示 之 内 。 

关于 递增 (increment) / 递减 (decrement) 操 作 的 更 多 信息 ， 请 参见 NCR 命令 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

执行 DECR 命令 之 后 key 的 值 。 


# 对 存在 的 数字 值 key 进行 DECR 


redis> SET failure times 10 
OK 


redis> DECR failure times 
(integer) 9 


# 对 不 存在 的 key 值 进行 DECR 


redis> EXISTS count 
(integer) 0 


redis> DECR count 
(integer) -1 


# 对 存在 但 不 是 数值 的 key 进行 DECR 


redis> SET company YOUR_CODE_SUCKS.LLC 
OK 


redis> DECR company 
(error) ERR value is not an integer or out of range 
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DECR 


DECRBY 


DECRBY key decrement 
将 key 所 储存 的 值 减 去 减 量 decrement o 
如 果 key 不 存在 ， 那 么 key 的 值 会 先 被 初始 化 为 0 ， 然 后 再 执行 DECRBY 


如 果 值 包含 错误 的 类 型 ， 或 字符 串 类 型 的 值 不 能 表示 为 数字 ， 那 么 返回 一 个 错误 。 
本 操作 的 值 限 制 在 64 位 (bit) 有 符号 数字 表示 之 内 。 

关于 更 多 递增 (increment) / 递减 (decrement) 操 作 的 更 多 信息 ， 请 参见 INCR MS. 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

减 去 decrement 之 后 ， key 的 值 。 


# 对 已 存在 的 key 进行 DECRBY 


redis> SET count 100 
OK 


redis> DECRBY count 20 
(integer) 80 


# 对 不 存在 的 key 进行 DECRBY 


redis> EXISTS pages 
(integer) 0 


redis> DECRBY pages 10 
(integer) -10 


GET 


GET key 
返回 key 所 关联 的 字符 串 值 。 
如 果 key 不 存在 那么 返回 特殊 值 nil 。 


假如 key 储存 的 值 不 是 字符 串 类 型 ， 返 回 一 个 错误 ， 因 为 GET 只 能 用 于 义理 字 
符 串 值 。 


可 用 版 本 : 
>= 1.0.0 

时 间 复 杂 度 : 
O(1) 

返回 值 : 


当 key 不 存在 时 ， 返 回 nil ， 否 则 ， 返 回 key 的 值 。 如 果 key 不 是 字符 
串 类 型 ， 那 么 返回 一 个 错误 。 


# 对 不 存在 的 key 或 字符 串 类 型 key 进行 GET 


redis> GET db 
(nil) 


redis> SET db redis 
OK 


redis> GET db 
"redis" 


# 对 不 是 字符 串 类 型 的 key 进行 GET 


redis> DEL db 
(integer) 1 


redis> LPUSH db redis mongodb mysql 
(integer) 3 


redis> GET db 
(error) ERR Operation against a key holding the wrong kind of value 








GETBIT 


GETBIT key offset 

xt key 所 储存 的 字符 串 值 ， 获 取 指定 偏 移 量 上 的 位 (bit)。 

4 offset 上 比 字 符 串 值 的 长 度 大 ， 或 者 key BEEN, WE 9 。 
可 用 版 本 : 

>= 2.2.0 

at) SAE: 

O(1) 

返回 值 : 

字符 串 值 指定 偏 移 量 上 的 位 (bit)。 


# 对 不 存在 的 key 或 者 不 存在 的 offset 进行 GETBIT, 返回 0 


redis> EXISTS bit 
(integer) 0 


redis> GETBIT bit 10086 
(integer) 0 


# 对 已 存在 的 offset 进行 GETBIT 


redis> SETBIT bit 10086 1 
(integer) 0 


redis> GETBIT bit 10086 
(integer) 1 


GETRANGE 


GETRANGE key start end 


返回 key 中 字符 串 值 的 子 字 符 串 ， 字 符 串 的 截取 范围 由 start 和 end 两 个 
偏 移 量 决定 (包括 start 和 end 在 内 )。 


负数 偏 移 量 表示 从 字符 串 最 后 开始 计数 ， -1 表示 最 后 一 个 字符 ， -2 表示 倒数 
第 二 个 ， 以 此 类 推 。 


GETRANGE 通过 保证 子 字符 串 的 值 域 (range) 不 超过 实际 字符 串 的 值 域 来 处 理 超 出 
范围 的 值 域 请 求 。 


Note 

在 <= 2.0 的 版 本 里 ，GETRANGE 被 叫 作 SUBSTR。 

可 用 版 本 : 

>= 2.4.0 

at SAE: 

O(N), N 为 要 返回 的 字符 串 的 长 度 。 复 条 度 最 终 由 字符 串 的 返回 值 长 度 决定 ， 但 
因为 从 已 有 字符 串 中 取出 子 字 符 串 的 操作 非常 廉价 (cheap)， 所 以 对 于 长 度 不 大 的 字 
符 串 ， 该 操作 的 复杂 度 也 可 看 作 O(1)。 

返回 值 : 

截取 得 出 的 子 字符 串 。 


redis> SET greeting "hello, my friend" 
OK 


redis> GETRANGE greeting 9 4 # 返回 索引 0 -4 的 字符 ， 包 括 4。 
"hello" 


redis> GETRANGE greeting -1 -5 # 不 支持 回 绕 操 作 


redis> GETRANGE greeting -3 -1 # 负数 索引 
"and" 


redis> GETRANGE greeting 0 -1 # 从 第 一 个 到 最 后 一 个 
"hello, my friend" 


redis> GETRANGE greeting © 1008611 # 值 域 范 围 不 超过 实际 字符 串 ， 超 过 部 
"hello, my friend" 


‘| — g i> | 
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GETRANGE 101 


GETSET 


GETSET key value 
将 给 定 key 的 值 设 为 value ， 并 返回 key 的 旧 值 (old value). 
当 key 存在 但 不 是 字符 串 类 型 时 ， 返 回 一 个 错误 。 
可 用 版 本 : 
>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

返回 给 定 key 的 旧 值 。 当 key 没有 旧 值 时 ， 也 即 是 ， key KEEN, RG 
nil 。 

redis> GETSET db mongodb # 没有 旧 值 ， 返 回 nil 

(nil) 


redis> GET db 
"mongodb" 


redis> GETSET db redis # 返回 旧 值 mongodb 
"mongodb" 


redis> GET db 
"redis" 


模式 
GETSET 可 以 和 INCR 组 合 使 用 ， 实 现 一 个 有 原子 性 (atomic) 复 位 操作 的 计数 器 
(counter)。 


举例 来 说 ， 每 次 当 某 个 事件 发 生 时 ， 进 程 可 能 对 一 个 名 为 mycount 的 key if 
用 INCR 操作 ， 通 常 我 们 还 要 在 一 个 原子 时 间 内 同时 完成 获得 计数 器 的 值 和 将 计数 
器 值 复 位 为 0 两 个 操作 。 


可 以 用 命令 GETSET mycounter 0 来 实现 这 一 目标 。 


redis> INCR mycount 
(integer) 11 


redis> GETSET mycount 0 
a be LeU 


redis> GET mycount 
"o" 


# 一 个 原子 内 完成 GET mycount 和 SET mycount 


# 计数 器 被 重 置 








INCR 


INCR key 
key 中 储存 的 数字 值 增 一 。 


如 果 key TEE, A key 的 值 会 先 被 初始 化 为 0 ， 然 后 再 执行 INCR 操 
作 。 


如 果 值 包含 错误 的 类 型 ， 或 字符 串 类 型 的 值 不 能 表示 为 数字 ， 那 么 返回 一 个 错误 。 
本 操作 的 值 限 制 在 64 位 (bit) 有 符号 数字 表示 之 内 。 
Note 


这 是 一 个 针对 字符 串 的 操作 ， 因 为 Redis 没有 专用 的 整数 类 型 ， 所 以 key 内 储存 的 
字符 串 被 解释 为 十 进 制 64 位 有 符号 整数 来 执行 INCR 操作 。 


可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

执行 INCR 命令 之 后 key 的 值 。 
redis> SET page_view 20 
OK 


redis> INCR page _view 
(integer) 21 


redis> GET page_view # 数字 值 在 Redis 中 以 字符 串 的 形式 保存 
io ee 


模式 : 计数 器 
计数 器 是 Redis 的 原子 性 自 增 操作 可 实现 的 最 直观 的 模式 了 ， 它 的 想法 相当 简单 : 
每 当 某 个 操作 发 生 时 ， 向 Redis 发 送 一 个 INCR RS. 


比如 在 一 个 web 应 用 程序 中 ， 如 果 想 知道 用 户 在 一 年 中 每 天 的 点 击 量 ， 那 么 只 要 将 
用 户 ID 以 及 相关 的 日 期 信息 作为 键 ， 并 在 每 次 用 户 点 击 页 面 时 ， 执 行 一 次 自 增 操 
作 即 可 。 


比如 用 户 名 是 peter ， 点 击 时 间 是 2012 年 3 月 22 日， 那么 执行 命令 
INCR peter::2012.3.22 。 


可 以 用 以 下 几 种 方式 扩展 这 个 简单 的 模式 : 


。 可 以 通过 组 合 使 用 INCR 和 EXPIRE ， 来 达到 只 在 规定 的 生存 时 间 内 进行 计数 
(counting) 的 目的 。 

。 客 户 端 可 以 通过 使 用 GETSET 命令 原子 性 地 获取 计数 器 的 当前 值 并 将 计数 器 
清 雾 ， 更 多 信息 请 参考 GETSET PR. 

e 使 用 其 他 自 增 / 自 减 操 作 ， 比 如 DECR 和 INCRBY ， 用 户 可 以 通过 执行 不 同 的 
操作 增加 或 减少 计数 器 的 值 ， 比 如 在 游戏 中 的 记分 器 就 可 能 用 到 这 些 命令 。 


模式 : 限 速 器 
限 速 器 是 特殊 化 的 计算 器 ， 它 用 于 限制 一 个 操作 可 以 被 执行 的 速率 (rate)。 


限 速 器 的 典型 用 法 是 限制 公开 API 的 请 求 次 数 ， 以 下 是 一 个 限 速 器 实现 示例 ， 它 将 
API 的 最 大 请 求 数 限制 在 每 个 IP 地 址 每 秒 钟 十 个 之 内 : 


FUNCTION LIMIT_API_CALL(ip) 
ts = CURRENT_UNIX_TIME() 
keyname = ipt":"+ts 

current = GET(keyname) 


IF current != NULL AND current > 10 THEN 
ERROR "too many requests per second" 
END 


IF current == NULL THEN 
MULTI 


INCR(keyname, 1) 
EXPIRE(keyname, 1) 


INCR(keyname, 1) 
END 


PERFORM_API_CALL() 


这 个 实现 每 秒 钟 为 每 个 IP 地 址 使 用 一 个 不 同 的 计数 器 ， 并 用 EXPIRE 命令 设置 生 
存 时 间 ( 这 样 Redis 就 会 负责 自动 删除 过 期 的 计数 器 )。 


注意 ， 我 们 使 用 事务 打包 执行 INCR ARAM EXPIRE 命令 ， 避 免 引 入 竞争 条 件 ， 保 
证 每 次 调用 API 时 都 可 以 正确 地 对 计数 器 进行 自 增 操 作 并 设置 生存 时 间 。 


以 下 是 另 一 个 限 速 器 实现 : 


FUNCTION LIMIT_API_CALL(ip): 
current = GET(ip) 
IF current != NULL AND current > 10 THEN 
ERROR "too many requests per second" 
ELSE 
value = INCR(ip) 
IF value == 1 THEN 
EXPIRE(ip, 1) 
END 
PERFORM_API_CALL() 
END 


这 个 限 速 器 只 使 用 单个 计数 器 ， 它 的 生存 时 间 为 一 秒 钟 ， 如 果 在 一 秒 钟 内 ， 这 个 计 
数 器 的 值 大 于 10 的 话 ， 那 么 访问 就 会 被 茶 止 。 


这 个 新 的 限 速 器 在 思路 方面 是 没有 问题 的 ， 但 它 在 实现 方面 不 够 严谨 ， 如 果 我 们 仔 
细 观 察 一 下 的 话 ， 就 会 发 现在 INCR 和 EXPIRE 之 间 存 在 着 一 个 竞争 条 件 ， 假 如 客 
户 端 在 执行 INCR 之 后 ， 因 为 某 些 原因 (比如 客户 端 失 败 ) 而 忘记 设置 EXPIRE 的 
话 ， 那 么 这 个 计数 器 就 会 一 直 存 在 下 去 ， 造 成 每 个 用 户 只 能 访问 10 次 ， 噢 ， 这 
简直 是 个 灾难 |! 


要 消灭 这 个 实现 中 的 竞争 条 件 ， 我 们 可 以 将 它 转 化 为 一 个 Lua 脚本 ， 并 放 到 Redis 
中 运行 (这 个 方法 仅 限于 Redis 2.6 及 以 上 的 版 本 ) : 


local current 

current = redis.call("incr",KEYS[1]) 

if tonumber(current) == 1 then 
redis.call("expire", KEYS[1],1) 

end 


通过 将 计数 器 作为 脚本 放 到 Redis 上 运行 ， 我 们 保证 了 INCR 和 EXPIRE 两 个 操作 
的 原子 性 ， 现 在 这 个 脚本 实现 不 会 引入 竞争 条 件 ， 它 可 以 运作 的 很 好 。 


关于 在 Redis 中 运行 Lua 脚本 的 更 多 信息 ， 请 参考 EVAL AD. 


还 有 另 一 种 消灭 竞争 条 件 的 方法 ， 就 是 使 用 Redis 的 列表 结构 来 代替 NCR HT, 
这 个 方法 无 须 脚 本 支持 ， 因 此 它 在 Redis 2.6 以 下 的 版 本 也 可 以 运行 得 很 好 : 


FUNCTION LIMIT_API_CALL(ip) 
current = LLEN(ip) 
IF current > 10 THEN 
ERROR "too many requests per second" 
ELSE 
IF EXISTS(ip) == FALSE 
MULTI 
RPUSH(ip, ip) 
EXPIRE(ip,1) 
EXEC 
ELSE 
RPUSHX(ip, ip) 
END 
PERFORM_API_CALL() 
END 


新 的 限 速 器 使 用 了 列表 结构 作为 容器 ，LLEN 用 于 对 访问 次 数 进 行 检查 ， 一 个 事务 
包 训 着 RPUSH 和 EXPIRE 两 个 命令 ， 用 于 在 第 一 次 执行 计数 时 创建 列表 ， 并 正确 
设置 地 设置 过 期 时 间 ， 最 后 ， RPUSHX 在 后 续 的 计数 操作 中 进行 增加 操作 。 


INCRBY 


INCRBY key increment 
将 key 所 储存 的 值 加 上 增 量 increment 。 
如 果 key AEE, PBA key 的 值 会 先 被 初始 化 为 0 ， 然 后 再 执行 INCRBY 


命令 

如 果 值 包含 错误 的 类 型 ， 或 字符 串 类 型 的 值 不 能 表示 为 数字 ， 那 么 返回 一 个 错误 。 
本 操作 的 值 限制 在 64 位 (bit) 有 符号 数字 表示 之 内 。 

关于 递增 (increment) / 递减 (decrement) 操 作 的 更 多 信息 ， 参 见 INCR. HA. 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

加 上 increment 之 后 ， key 的 值 。 


# key 存在 且 是 数字 值 


redis> SET rank 50 
OK 


redis> INCRBY rank 20 
(integer) 70 


redis> GET rank 
W 70 " 


# key 不 存在 时 


redis> EXISTS counter 
(integer) 0 


redis> INCRBY counter 30 
(integer) 30 


redis> GET counter 
" 30 " 


# key 不 是 数字 值 时 


redis> SET book "long long ago..." 
OK 


redis> INCRBY book 200 
(error) ERR value is not an integer or out of range 


INCRBYFLOAT 


INCRBYFLOAT key increment 
为 key 中 所 储存 的 值 加 上 浮 点 数 增 量 increment 。 


如 果 key 不 存在 ， 那 么 INCRBYFLOAT RAIF key 的 值 设 为 ”9 ， 再 执行 加 
法 操作 。 


如 果 命 令 执 行 成 功 ， 那 么 key 的 值 会 被 更 新 为 执行 加 法 之 后 的 ) 新 值 ， 并 且 新 
会 以 字符 串 的 形式 返回 给 调用 者 。 


无 论 是 key B, REE increment ， 都 可 以 使 用 像 2.0e7 、 3e5 、 
90e-2 那样 的 指数 符号 (exponential notation) 来 表示 ， 但 是 ， 执 行 
INCRBYFLOAT 命令 之 后 的 值 总 是 以 同样 的 形式 储存 ， 也 即 是 ， 它 们 总 是 由 一 个 数 
字 ， 一 个 (可 选 的 ) 小 数 点 和 一 个 任意 位 的 小 数 部 分 组 成 (比如 3.14 、 

69.768 ， 诸 如 此 类 )， 小 数 部 分 尾随 的 6 会 被 移 除 ， 如 果 有 需要 的 话 ， 还 会 将 
浮 点 数 改 为 整数 (比如 3.0 会 被 保存 成 3 ) 。 


除 此 之 外 ， 无 论 加 法 计算 所 得 的 浮 点 数 的 实际 精度 有 多 长 ， INCRBYFLOAT 的 计 
算 结 果 也 最 多 只 能 表示 小 数 点 的 后 十 七 位 。 


当 以 下 任意 一 个 条 件 发 生 时 ， 返 回 一 个 错误 : 
e。 key 的 值 不 是 字符 串 类 型 (因为 Redis 中 的 数字 和 浮 点 数 都 以 字符 串 的 形式 保 
存 ， 所 以 它们 都 属于 字符 串 类 型 ) 


e key 当前 的 值 或 者 给 定 的 增 量 increment 不 能 解释 (parse) 为 双 精 度 浮 点 
数 (double precision floating point number) 


可 用 版 本 : 

>= 2.6.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

执行 命令 之 后 key 的 值 。 


# 值 和 增 量 都 不 是 指数 符号 


redis> SET mykey 10.50 
OK 


redis> INCRBYFLOAT mykey 0.1 
ONG 


# 值 和 增 量 都 是 指数 符号 


redis> SET mykey 314e-2 


OK 
redis> GET mykey # 用 SET 设置 的 值 可 以 是 指数 符号 
"314e-2" 

redis> INCRBYFLOAT mykey 0 # 但 执行 INCRBYFLOAT ZEBRA RAFI 
Wied Lab 


# 可 以 对 整数 类 型 执行 


redis> SET mykey 3 
OK 


redis> INCRBYFLOAT mykey 1.1 
Aenea 


# 后 跟 的 9 会 被 移 除 


redis> SET mykey 3.0 
OK 


redis> GET mykey # SET 设置 的 值 小 
"3,0" 


redis> INCRBYFLOAT mykey 1.000000000000000000000 # 但 INCRBYFLOA 
wA 


redis> GET mykey 
wAn 





MGET 


MGET key [key ...] 
返回 所 有 (一 个 或 多 个 ) 给 定 key 的 值 。 


如 果 给 定 的 key 里 面 ， 有 某 个 key 不 存在 ， 那 么 这 个 key 返回 特殊 值 
nil 。 因 此 ， 该 命令 永 不 失败 。 


可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(N), N 为 给 定 key 的 数量 。 

返回 值 : 

一 个 包含 所 有 给 定 key 的 值 的 列表 。 
redis> SET redis redis.com 
OK 


redis> SET mongodb mongodb.org 
OK 


redis> MGET redis mongodb 
1) "redis.com" 
2) "mongodb.org" 


redis> MGET redis mongodb mysql # 不 存在 的 mysql 返回 nil 
1) "redis.com" 

2) "mongodb.org" 

3) (nil) 


MSET 


MSET key value [key value ...] 
同时 设置 一 个 或 多 个 key-value 对 。 


如 果 某 个 给 定 key GARE, AA MSET 会 用 新 值 履 盖 原 来 的 旧 值 ， 如 果 这 不 
是 你 所 希望 的 效果 ， 请 考虑 使 用 MSETNX 命令 : 它 只 会 在 所 有 给 定 key 都 不 存 
在 的 情况 下 进行 设置 操作 。 


MSET 是 一 个 原子 性 (atomic) 操 作 ， 所 有 给 定 key 都 会 在 同一 时 间 内 被 设置 ， 某 
些 给 定 key 被 更 新 而 另 一 些 给 定 key 没有 改变 的 情况 ， 不 可 能 发 生 。 


可 用 版 本 : 
>= 1.0.1 
时 间 复 条 度 : 
O(N), N 为 要 设置 的 key 数量 。 
返回 值 : 
总 是 返回 ok (因为 MSET 不 可 能 失败 ) 
redis> MSET date "2012.3.30" time "11:00 a.m." weather "sunny" 
OK 
redis> MGET date time weather 
1) "2012.3.30" 
2) "11:00 a.m." 
3) "sunny" 


# MSET ÆA IREBE 


redis> SET google "google.hk" 
OK 


redis> MSET google "google.com" 
OK 


redis> GET google 
"google.com" 


MSETNX 


MSETNX key value [key value ...] 
同时 设置 一 个 或 多 个 key-value 对 ， 当 且 仅 当 所 有 给 定 key 都 不 存在 。 


即使 只 有 一 个 给 定 key 已 存在 ， MSETNX 也 会 拒绝 执行 所 有 给 定 key 的 设置 
操作 。 


MSETNX 是 原子 性 的 ， 因 此 它 可 以 用 作 设 置 多 个 不 同 key 表示 不 同 字 段 (field) 的 
唯一 性 逻辑 对 象 (unique logic object)， 所 有 字段 要 么 全 被 设置 ， 要 么 全 不 被 设置 。 


可 用 版 本 : 
>= 1.0.1 
时 间 复杂 度 : 
O(N), N 为 要 设置 的 key 的 数量 。 
返回 值 : 
当 所 有 key 都 成 功 设 置 ， 返 回 1 。 如 果 所 有 给 定 key 都 设置 失败 (至 少 有 一 
个 key BAFE) MARE 6 。 
# 对 不 存在 的 key 进行 MSETNX 


redis> MSETNX rmdbs "MySQL" nosql "MongoDB" key-value-store "redis' 
(integer) 1 


redis> MGET rmdbs nosql key-value-store 


1) "MySQL" 
2) "MongoDB" 
3) "redis" 


# MSET 的 给 定 key 当中 有 已 存在 的 key 


redis> MSETNX rmdbs "Sqlite" language "python" # rmdbs 键 已 经 存在 ，] 
(integer) 0 


redis> EXISTS language # 因为 MSET 是 原子 性 
(integer) 0 


redis> GET rmdbs # rmdbs 也 没有 被 修改 
"MySQL" 


«| = 








PSETEX 


PSETEX key milliseconds value 


这 个 命令 和 SETEX MDAU, BELZA ŽARE key 的 生存 时 间 ， 而 不 是 
像 SETEX 命令 那样 ， 以 秒 为 单位 。 


可 用 版 本 : 

>= 2.6.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

设置 成 功 时 返回 OK 。 
redis> PSETEX mykey 1000 "Hello" 
OK 


redis> PTTL mykey 
(integer) 999 


redis> GET mykey 
"Hello" 


SET 


SET key value [EX seconds] [PX milliseconds] [NX|XX] 
将 字符 串 值 value 关联 到 key o 
如 果 key 已 经 持 有 其 他 值 ， SET 就 覆 写 旧 值 ， 无 视 类 型 。 


对 于 某 个 原本 带 有 生存 时 间 (TTL) 的 键 来 涪 ， 当 SET 命令 成 功 在 这 个 键 上 执行 
时 ， 这 个 键 原 有 的 TTL 将 被 清除 。 


可 选 参数 
从 Redis 2.6.12 版 本 开始 ， SET 命令 的 行为 可 以 通过 一 系列 参数 来 修改 : 


e EX second : 设置 键 的 过 期 时 间 为 second 秒 。 
SET key value EX second 效果 等 同 于 SETEX key second value 。 
e PX millisecond : 设置 键 的 过 期 时 间 为 millisecond 毫秒 。 
SET key value PX millisecond 效果 等 同 于 
PSETEX key millisecond value 。 
。 NX : 只 在 键 不 存在 时 ， 才 对 键 进 行 设置 操作 。 SET key value NX 效果 
等 同 于 SETNX key value 。 
。 XX :只 在 键 已 经 存在 时 ， 才 对 键 进行 设置 操作 。 


Note 


为 SET 命令 可 以 通过 参数 来 实现 和 SETNX、 SETEX 和 PSETEX 三 个 命令 的 
效果 ， 所 以 将 来 的 Redis 版 本 可 能 会 废弃 并 最 终 移 除 SETNX 、 SETEX 和 
PSETEX 这 三 个 命令 。 


可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

Wl) 4a : 

在 Redis 2.6.12 版 本 以 前 ， SET 命令 总 是 返回 OK o 


从 Redis 2.6.12 版 本 开始 ， SET 在 设置 操作 成 功 完成 时 ， 才 返回 ok 。 如 果 设 置 
了 NX 或 者 Xx ， 但 因为 条 件 没 达到 而 造成 设置 操作 未 执行 ， 那 么 命令 返回 空 批 
量 回复 (NULL Bulk Reply) 。 


# 对 不 存在 的 键 进 行 设 置 


redis 127.0.0.1:6379> SET key "value" 


OK 


redis 127.0.0.1:6379> 
"value" 


# 对 已 存在 的 键 进行 设置 


redis 127.0.0.1:6379> 
OK 


redis 127.0.0.1:6379> 
"new-value" 


# 使 用 EX 选项 


redis 127.0.0.1:6379> 
OK 


redis 127.0.0.1:6379> 
"hello" 


redis 127.0.0.1:6379> 
(integer) 10069 


# 使 用 PX 选项 


redis 127.0.0.1:6379> 
OK 


redis 127.0.0.1:6379> 
"moto" 


redis 127.0.0.1:6379> 
(integer) 111939 


# 使 用 NX 选项 


GET 


SET 


GET 


SET 


GET 


TTL 


SET 


GET 


key 


key "new-value" 


key 


key-with-expire-time "hello" EX 10086 


key-with-expire-time 


key-with-expire-time 


key-with-pexpire-time "moto" PX 123321 


key-with-pexpire-time 


PTTL key-with-pexpire-time 


redis 127.0.0.1:6379> SET not-exists-key "value" NX 
OK # 键 不 存在 ， 设 置 成 功 


redis 127.0.0.1:6379> GET not-exists-key 


"value" 


redis 127.0.0.1:6379> SET not-exists-key "new-value" NX 
(nil) # 键 已 经 存在 ， 设 置 失败 


redis 127.0.0.1:6379> GEt not-exists-key 


"value" # 维持 原 值 不 变 


# 使 用 XX 选项 


redis 127.0.0.1:6379> EXISTS exists-key 


(integer) 0 


redis 127.0.0.1:6379> SET exists-key "value" XX 
(nil) # 因为 键 不 存在 ， 设 置 失败 


redis 127.0.0.1:6379> SET exists-key "value" 
OK # 先 给 键 设置 一 个 值 


redis 127.0.0.1:6379> SET exists-key "new-value" XX 
OK # 设置 新 值 成 功 


redis 127.0.0.1:6379> GET exists-key 
"new-value" 


# NX 或 XX 可 以 和 EX 或 者 PX 组 合 使 用 


redis 127.0.0.1:6379> SET key-with-expire-and-NX "hello" EX 10086 1 
OK 


redis 127.0.0.1:6379> GET key-with-expire-and-Nx 
"hello" 


redis 127.0.0.1:6379> TTL key-with-expire-and-Nx 
(integer) 10063 


redis 127.0.0.1:6379> SET key-with-pexpire-and-XX "old value" 
OK 


redis 127.0.0.1:6379> SET key-with-pexpire-and-XX "new value" PX 1: 
OK 


redis 127.0.0.1:6379> GET key-with-pexpire-and -XX 
"new value" 


redis 127.0.0.1:6379> PTTL key-with-pexpire-and-XxX 
(integer) 112999 


# EX 和 PX 可 以 同时 出 现 ， 但 后 面 给 出 的 选项 会 覆盖 前 面 给 出 的 选项 


redis 127.0.0.1:6379> SET key "value" EX 1000 PX 5000000 
OK 


redis 127.0.0.1:6379> TTL key 
(integer) 4993 # 这 是 PX 参数 设置 的 值 


redis 127.0.0.1:6379> SET another-key "value" PX 5000000 EX 1000 
OK 


redis 127.0.0.1:6379> TTL another-key 
(integer) 997 # 这 是 EX 参数 设置 的 值 











使 用 模式 


命令 SET resource-name anystring NX EX max-lock-time 是 一 种 在 Redis 


中 实现 锁 的 简单 方法 。 
客户 端 执 行 以 上 的 命令 : 


e。 如 果 服 务 器 返回 OK ， 那 么 这 个 客户 端 获得 锁 。 
e 如 果 服 务 器 返回 NIL , MBA 可 以 在 稍 后 再 重 试 。 


置 的 过 期 时 间 到 达 之 后 ， 锁 将 自动 释放 。 
可 以 通过 以 下 修改 ， 让 这 个 锁 实 现 更 健壮 : 


。 不 使 用 固定 的 字符 串 作 为 键 的 值 ， 而 是 设置 一 个 不 可 猜测 (non-guessable) 
的 长 随机 字符 串 ， 作 为 口令 串 (token) 。 
。 不 使 用 DEL 命令 来 释放 锁 ， 而 是 发 送 一 + Lua 脚本 ， 这 个 脚本 只 在 客户 端 伟 
入 的 值 和 键 的 口令 串 相 匹配 时 ， 才 对 键 进 行 删 除 。 
这 两 个 改动 可 以 防止 持 有 过 期 锁 的 客户 端 误 删 现 有 锁 的 情况 出 现 。 


以 下 是 一 个 简单 的 解锁 脚本 示例 : 


if redis.call("get",KEYS[1]) == ARGV[1] 


then 
return redis.call("del",KEYS[1]) 
else 
return 0 
end 
这 个 脚本 可 以 通过 EVAL ...script... 1 resource-name token-value AP 


来 调用 。 


SETBIT 


SETBIT key offset value 

对 key 所 储存 的 字符 串 值 ， 设 置 或 清除 指定 偏 移 量 上 的 位 (bit)。 
位 的 设置 或 清除 取决 于 value 参数 ， 可 以 是 o 也 可 以 是 1. 
当 key 不 存在 时 ， 自 动 生成 一 个 新 的 字符 串 值 。 


字符 串 会 进行 伸展 (grown) 以 确保 它 可 以 将 value 保存 在 指定 的 偏 移 量 上 。 当 字 
符 串 值 进行 伸展 时 ， 空 白 位 置 以 6 填充 。 


offset 参数 必须 大 于 或 等 于 o ， 小 于 2432 (bit 映射 被 限制 在 512 MB ZA), 
Warning 


对 使 用 大 的 offset 的 SETBIT 操作 来 说 ， 内 存 分 配 可 能 造成 Redis 服务 器 被 阻 
塞 。 具 体 参 考 SETRANGE 命 爷 ，warning( 警 告 ) 部 分 。 


可 用 版 本 : 

>= 2.2.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

指定 偏 移 量 原来 储存 的 位 。 
redis> SETBIT bit 10086 1 
(integer) 0 


redis> GETBIT bit 10086 
(integer) 1 


redis> GETBIT bit 100 # bit 默认 被 初始 化 为 0 
(integer) 0 


SETEX 


SETEX key seconds value 


将 值 value 关联 到 key ， 并 将 key 的 生存 时 间 设 为 seconds (以 秒 为 单 
位 )。 


如 果 key 已 经 存在 ， SETEX ASNES. 
这 个 命令 类 似 于 以 下 两 个 命令 : 


SET key value 
EXPIRE key seconds # 设置 生存 时 间 


不 同 之 处 是 ， SETEX 是 一 个 原子 性 (atomic) 操 作 ， 关 联 值 和 设置 生存 时 间 两 个 动 
作 会 在 同一 时 间 内 完成 ， 该 命令 在 Redis 用 作 缓 存 时 ， 非 常 实 用 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

设置 成 功 时 返回 ok 。 当 seconds 参数 不 合法 时 ， 返 回 一 个 错误 。 


# 在 key 不 存在 时 进行 SETEX 


redis> SETEX cache_user_id 60 10086 
OK 


redis> GET cache user id # 值 
"10086" 


redis> TTL cache_user_id # 剩余 生存 时 间 
(integer) 49 


# key 已 经 存在 时 ，SETEX BRIA 


redis> SET cd "timeless" 
OK 


redis> SETEX cd 3000 "goodbye my love" 
OK 


redis> GET cd 
"goodbye my love" 


redis> TTL cd 
(integer) 2997 


SETNX 


SETNX key value 
key 的 值 设 为 value ， 当 且 仅 当 key FEE. 
若 给 定 的 key 已 经 存在 ， 则 SETNX 不 做 任何 动作 。 
SETNX Æ [ISET if Not eXists] (如 果 不 存 在 ， 则 SET) 的 简写 。 
可 用 版 本 : 
>= 1.0.0 
时 间 复 杂 度 : 
O(1) 
返回 值 : 
设置 成 功 ， 返 回 1 。 设 置 失败 ， 返 回 6 。 
redis> EXISTS job # job 不 存在 
(integer) 0 


redis> SETNX job "programmer" # job 设置 成 功 
(integer) 1 


redis> SETNX job "code-farmer" # 尝试 覆盖 job, Am 
(integer) 0 


redis> GET job # 没有 被 覆盖 
"programmer" 


SETRANGE 


SETRANGE key offset value 


FA value 参数 履 写 (overwrite) 给 定 key 所 储存 的 字符 串 值 ， 从 偏 移 量 
offset 开始 。 


不 存在 的 key 当 作 空白 字符 串 处 理 。 


SETRANGE 命令 会 确保 字符 串 足 够 长 以 便 将 value 设置 在 指定 的 偏 移 量 上 ， 如 
RAT key 原来 储存 的 字符 串 长 度 比 偏 移 量 小 (比如 字符 串 只 有 5 个 字符 长 ， 
但 你 设置 的 offset 是 10 )， 那 么 原 字 符 和 偏 移 量 之 间 的 空白 将 用 需 字 节 
(zerobytes, "\xoo" ) 来 填充 。 


注意 你 能 使 用 的 最 大 偏 移 量 是 2^29-1(536870911) ， 因 为 Redis 字符 串 的 大 小 被 限 
制 在 512 兆 (megabytes) 以 内 。 如 果 你 需要 使 用 比 这 更 大 的 空间 ， 你 可 以 使 用 多 个 
key o 


Warning 


当 生 成 一 个 很 长 的 字符 串 时 ，Redis 需要 分 配 内 存 空 间 ， 该 操作 有 时 候 可 能 会 造成 
服务 器 阻塞 (block)。 在 2010 年 的 Macbook Pro 上 ， 设 置 偏 移 量 为 
536870911(512MB Ac), RY 300 宣 秒 ， 设置 偏 移 量 为 
134217728(128MB 内 存 分 配 )， 耗 费 约 80 毫秒 ， 设 置 偏 移 量 33554432(32MB 内 
存 分 配 )， 耗 费 约 30 毫秒 ， 设 置 偏 移 量 为 8388608(8MB ADE), HRYSE 
秒 。 注意 若 首次 内 存 分 配 成 功 之 后 ， 再 对 同一 个 key 调用 SETRANGE 操作 ， 
无 须 再 重新 内 存 。 


可 用 版 本 : 
>= 2.2.0 
时 间 复 杂 度 : 


对 小 (small) 的 字符 串 ， 平 捧 复 末 度 O(1)。( 关 于 什么 字符 串 是 ?小 "的 ， 请 参考 
APPEND 命令 ) 否 则 为 OIM)， M 为 value BRAKE. 


返回 值 : 
被 SETRANGE 修改 之 后 ， 字 符 串 的 长 度 。 


# 对 非 空 字符 串 进 行 SETRANGE 


redis> SET greeting "hello world" 
OK 


redis> SETRANGE greeting 6 "Redis" 
(integer) 11 


redis> GET greeting 
"hello Redis" 


# 对 空 字符 串 / 不 存在 的 key 进行 SETRANGE 


redis> EXISTS empty_string 
(integer) 0 


redis> SETRANGE empty_string 5 "Redis!" # 对 不 存在 的 key 使 用 SETRA 
(integer) 11 


redis> GET empty_string # 空白 处 被 "\x90" 填 充 
"\xO0\xO0\xOO0\xOO0\xOORedis!" 


4 a 
模式 
因为 有 了 SETRANGE 和 GETRANGE 命令 ， 你 可 以 将 Redis 字符 串 用 作 具 有 O(1) 


随机 访问 时 间 的 线性 数组 ， 这 在 很 多 真实 用 例 中 都 是 非常 快速 且 高 效 的 储存 方式 ， 
具体 请 参考 APPEND 命令 的 『 模 式 : 时 间 序 列 」 部分。 





STRLEN 


STRLEN key 

返回 key 所 储存 的 字符 串 值 的 长 度 。 

4 key 储存 的 不 是 字符 串 值 时 ， 返 回 一 个 错误 。 
可 用 版 本 : 

>= 2.2.0 

BRE: 

O(1) 

Wl) 4a : 

字符 串 值 的 长 度 。 当 key BEN, RE 6 。 


# 获取 字符 串 的 长 度 


redis> SET mykey "Hello world" 
OK 


redis> STRLEN mykey 
(integer) 11 


# 不 存在 的 key KEX 0 


redis> STRLEN nonexisting 
(integer) 0 


Hash ( 哈 希 表 ) 


HDEL 


HDEL key field [field ...] 
删除 哈 希 表 key 中 的 一 个 或 多 个 指定 域 ， 不 存在 的 域 将 被 忽略 。 
Note 


在 Redis2.4 以 下 的 版 本 里 ， HDEL 每 次 只 能 删除 单个 域 ， 如 果 你 需要 在 一 个 原子 时 
间 内 删除 多 个 域 ， 请 将 命令 包含 在 MULTI / EXEC 块 内 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(N), N 为 要 删除 的 域 的 数量 。 

返回 值 : 

被 成 功 移 除 的 域 的 数量 ， 不 包括 被 忽略 的 域 。 


# 测试 数据 


redis> HGETALL abbr 


1) waw 

2) "apple" 
3) UHA 

4) "banana" 
5) WEN 

6) "cat" 

7) Uira pu 

8) "dog" 


# 删除 单个 域 


redis> HDEL abbr a 
(integer) 1 


# 删除 不 存在 的 域 


redis> HDEL abbr not-exists-field 
(integer) 0 


# 删除 多 个 域 


redis> HDEL abbr bc 
(integer) 2 


redis> HGETALL abbr 
1) wat! 
2) "dog" 


HEXISTS 


HEXISTS key field 
查看 哈 希 表 key 中 ， 给 定 域 field 是 否 存在 。 
可 用 版 本 : 
>= 2.0.0 
时 间 复 条 度 : 
O(1) 
返回 值 : 
如 果 哈 希 表 含有 给 定 域 ， 返 回 1 。 如 果 哈 希 表 不 含有 给 定 域 ， 或 key 不 存在 ， 
返回 0 。 
redis> HEXISTS phone myphone 
(integer) 0 


redis> HSET phone myphone nokia-1110 
(integer) 1 


redis> HEXISTS phone myphone 
(integer) 1 


HGET 


HGET key field 

返回 哈 希 表 key 中 给 定 域 field 的 值 。 

可 用 版 本 : 

>= 2.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

给 定 域 的 值 。 当 给 定 域 不 存在 或 是 给 定 key 不 存在 时 ， 返 回 nil 。 


# 域 存在 


redis> HSET site redis redis.com 
(integer) 1 


redis> HGET site redis 
"redis.com" 


# 域 不 存在 


redis> HGET site mysql 
(nil) 


HGETALL 


HGETALL key 
返回 哈 希 表 key 中 ， 所 有 的 域 和 值 。 


在 返回 值 里 ， 紧 跟 每 个 域名 (field name) 之 后 是 域 的 值 (value)， 所 以 返回 值 的 长 度 是 
哈 希 表 大 小 的 两 倍 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(N), N 为 哈 希 表 的 大 小 。 

返回 值 : 

以 列表 形式 返回 哈 希 表 的 域 和 域 的 值 。 若 key 不 存在 ， 返 回 空 列表 。 
redis> HSET people jack "Jack Sparrow" 
(integer) 1 


redis> HSET people gump "Forrest Gump" 
(integer) 1 


redis> HGETALL people 


1) "jack" # 域 
2) "Jack Sparrow" # 值 
3) "gump" 


4) "Forrest Gump" 


HINCRBY 


HINCRBY key field increment 

为 哈 希 表 key PM field 的 值 加 上 增 量 increment o 

增 量 也 可 以 为 负数 ， 相 当 于 对 给 定 域 进行 减法 操作 。 

如 果 key 不 存在 ， 一 个 新 的 哈 希 表 被 创建 并 执行 HINCRBY MD 
如 果 域 field 不 存在 ， 那 么 在 执行 命令 前 ， 域 的 值 被 初始 化 为 9 。 
对 一 个 储存 字符 串 值 的 域 field 执行 HINCRBY 命令 将 造成 一 个 错误 。 
本 操作 的 值 被 限制 在 64 位 (bit) 有 符号 数字 表示 之 内 。 

可 用 版 本 : 

>= 2.0.0 

时 间 复杂 度 : 

O(1) 

返回 值 : 

执行 HINCRBY 命令 之 后 ， 哈 希 表 key Pi field 的 值 。 


# increment 为 正 数 


redis> HEXISTS counter page_view # 对 空域 进行 设置 
(integer) 0 


redis> HINCRBY counter page_view 200 
(integer) 200 


redis> HGET counter page_view 
" 200 " 


# increment 为 负数 


redis> HGET counter page_view 
" 200 " 


redis> HINCRBY counter page_view -50 
(integer) 150 


redis> HGET counter page_view 
" 150 " 


# 党 试 对 字符 串 值 的 域 执行 HINCRBY 命 兮 


redis> HSET myhash string hello,world # 设 定 一 个 字符 串 值 
(integer) 1 


redis> HGET myhash string 
"hello, world" 


redis> HINCRBY myhash string 1 H 命令 执行 失败 ， 错 误 。 
(error) ERR hash value is not an integer 


redis> HGET myhash string # RATE 
"hello, world" 


HINCRBYFLOAT 


HINCRBYFLOAT key field increment 
为 哈 希 表 key 中 的 域 field 加 上 浮 点 数 增 量 increment 。 


如 果 哈 希 表 中 没有 域 field ， 那 么 HINCRBYFLOAT 会 先 将 域 field 的 值 设 
为 0 ， 然 后 再 执行 加 法 操作 。 


如 果 键 key 不 存在 ， 那 么 HINCRBYFLOAT 会 先 创建 一 个 哈 希 表 ， 再 创建 域 
field ， 最 后 再 执行 加 法 操作 。 


当 以 下 任意 一 个 条 件 发 生 时 ， 返 回 一 个 错误 : 


e 域 field 的 值 不 是 字符 串 类 型 (因为 redis 中 的 数字 和 浮 点 数 都 以 字符 串 的 形 
式 保存 ， 所 以 它们 都 属于 字符 串 类 型 ) 

。 域 field 当前 的 值 或 给 定 的 增 量 increment 不 能 解释 (parse) 为 双 精 度 浮 
点 数 (double precision floating point number) 


HINCRBYFLOAT 命令 的 详细 功能 和 INCRBYFLOAT 命 合 类 似 ， 请 查看 
INCRBYFLOAT 命令 获取 更 多 相关 信息 。 


可 用 版 本 : 

>= 2.6.0 

时 间 复 杂 度 : 

O(1) 

Wl) (a : 

执行 加 法 操作 之 后 field 域 的 值 。 


# 值 和 增 量 都 是 普通 小 数 


redis> HSET mykey field 10.50 
(integer) 1 

redis> HINCRBYFLOAT mykey field 0.1 
"460, 6" 


# 值 和 增 量 都 是 指数 符号 


redis> HSET mykey field 5.0e3 
(integer) 0 

redis> HINCRBYFLOAT mykey field 2.0e2 
"5200" 


# 对 不 存在 的 键 执 行 HINCRBYFLOAT 


redis> EXISTS price 

(integer) 0 

redis> HINCRBYFLOAT price milk 3.5 
Wer fw 

redis> HGETALL price 

1) "milk" 

2) "37y 


# 对 不 存在 的 域 进 行 HINCRBYFLOAT 


redis> HGETALL price 

1) "milk" 

2) vee 

redis> HINCRBYFLOAT price coffee 4.5 
VARS 

redis> HGETALL price 


ol) MIKY 
2) Weed th 
3) "coffee" 


4) "4 5" 


# 新 增 coffee 域 


HKEYS 


HKEYS key 

返回 哈 希 表 key 中 的 所 有 域 。 

可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(N), N 为 哈 希 表 的 大 小 。 

返回 值 : 

一 个 包含 哈 希 表 中 所 有 域 的 表 。 当 key 不 存在 时 ， 返 回 一 个 空 表 。 


H 哈 希 表 非 空 


redis> HMSET website google www.google.com yahoo www.yahoo.com 
OK 


redis> HKEYS website 
1) "google" 

2) "yahoo" 

# 空 哈 希 表 /key 不 存在 


redis> EXISTS fake_key 
(integer) 0 


redis> HKEYS fake_key 
(empty list or set) 


HLEN 


HLEN key 


返回 哈 希 表 key 中 域 的 数量 。 


时 间 复 杂 度 : 

O(1) 

返回 值 : 

哈 希 表 中 域 的 数量 。 
redis> HSET db 
(integer) 1 


redis> HSET db 
(integer) 1 


redis> HLEN db 
(integer) 2 


redis> HSET db 
(integer) 1 


redis> HLEN db 
(integer) 3 


当 key PEE, WE 0 。 


redis redis.com 


mysql mysql.com 


mongodb mongodb.org 


HMGET 


HMGET key field [field ...] 
返回 哈 希 表 key 中， 一 个 或 多 个 给 定 域 的 值 。 
如 果 给 定 的 域 不 存在 于 哈 希 表 ， 那 么 返回 一 个 nil 值 。 


因为 不 存在 的 key 被 当 作 一 个 空 哈 希 胡来 处理 ， 所 以 对 一 个 不 存在 的 key it 
47 HMGET 操作 将 返回 一 个 只 帝 有 nil 值 的 表 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(N), AN 为 给 定 域 的 数量 。 

返回 值 : 

~ 定 域 的 关联 值 的 表 ， 表 值 的 排列 顺序 和 给 定 域 参数 的 请 求 顺 序 一 
Žo 


redis> HMSET pet dog "doudou" cat "nounou" # 一 次 设置 多 个 域 
OK 


redis> HMGET pet dog cat fake_pet # 返回 值 的 顺序 和 传人 参数 
1) "doudou" 


2) "nounou" 
3) (nil) # 不 存在 的 域 返回 nil 值 


D E l 





HMSET 


HMSET key field value [field value ...] 
同时 将 多 个 field-value ( 域 - 值 ) 对 设置 到 哈 希 表 key 中 。 
此 命令 会 覆盖 哈 希 表 中 已 存在 的 域 。 
如 果 key 不 存在 ， 一 个 空 哈 希 表 被 创建 并 执行 HMSET 操作 。 
可 用 版 本 : 
>= 2.0.0 
时 间 复 条 度 : 
O(N), N 为 field-value 对 的 数量 。 
返回 值 : 
如 果 命 令 执 行 成 功 ， 返 回 oK 。 当 key 不 是 哈 希 表 (hash) 类 型 时 ， 返 回 一 个 错 
误 。 
redis> HMSET website google www.google.com yahoo www.yahoo.com 


OK 


redis> HGET website google 
"www.google.com" 


redis> HGET website yahoo 
"www.yahoo.com" 


HSET 


HSET key field value 

将 哈 希 表 key 中 的 域 field 的 值 设 为 value . 

如 果 key 不 存在 ， 一 个 新 的 哈 希 表 被 创建 并 进行 HSET 操作 。 

如 果 域 field 已 经 存在 于 哈 希 表 中 ， 旧 值 将 被 覆盖 。 

可 用 版 本 : 

>= 2.0.0 

ay a] RAE: 

O(1) 

返回 值 : 

如 果 field 是 哈 希 表 中 的 一 个 新 建 域 ， 并 且 值 设置 成 功 ， 返 回 1 。 如 果 哈 希 

RPR field 已 经 存在 且 旧 值 已 被 新 值 覆 盖 ， 返 回 9 。 
redis> HSET website google "www.g.cn" # 设置 一 个 新 域 
(integer) 1 


redis> HSET website google "www.google.com" # 覆盖 一 个 旧 域 
(integer) 0 


HSETNX 


HSETNX key field value 


将 哈 希 表 key PAY field 的 值 设 置 为 value ， 当 且 仅 当 域 field A 
在 。 


若 域 field 已 经 存在 ， 该 操作 无 效 。 

如 果 key 不 存在 ， 一 个 新 哈 希 表 被 创建 并 执行 HSETNX 命 邻 。 

可 用 版 本 : 

>= 2.0.0 

BY a] RAE: 

O(1) 

返回 值 : 

设置 成 功 ， 返 回 1 。 如 果 给 定 域 已 经 存在 且 没有 操作 被 执行 ， 返 回 6 。 
redis> HSETNX nosql key-value-store redis 
(integer) 1 


redis> HSETNX nosql key-value-store redis # 操作 无 效 ， 域 key-ve 
(integer) 0 


E TE 5 





HVALS 


HVALS key 

返回 哈 希 表 key 中 所 有 域 的 值 。 

可 用 版 本 : 

>= 2.0.0 

时 间 复 条 度 : 

O(N), N 为 哈 希 表 的 大 小 。 

返回 值 : 

一 个 包含 哈 希 表 中 所 有 值 的 表 。 当 key 不 存在 时 ， 返 回 一 个 空 表 。 


# 非 空 哈 希 表 


redis> HMSET website google www.google.com yahoo www.yahoo.com 
OK 


redis> HVALS website 


1) "www.google.com" 
2) "www.yahoo.com" 


# 空 哈 希 表 / 不 存在 的 key 


redis> EXISTS not_exists 
(integer) 0 


redis> HVALS not_exists 
(empty list or set) 


HSCAN 


HSCAN key cursor [MATCH pattern] [COUNT count] 
具体 信息 请 参考 SCAN 命令 。 


List (列表 ) 


BLPOP 


BLPOP key [key ...] timeout 
BLPOP 是 列表 的 阻塞 式 (blocking) 弹 出 原 语 。 


它 是 LPOP 命令 的 阻塞 版 本 ， 当 给 定 列表 内 没有 任何 元 素 可 供 漳 出 的 时 候 ， 连 接 将 
被 BLPOP 命令 阻塞 ， 直 到 等 待 超时 或 发 现 可 弹出 元 素 为 止 。 


当 给 定 多 个 key 参数 时 ， 按 参数 key 的 先后 顺序 依次 检查 各 个 列表 ， 弹 出 第 
一 个 非 空 列表 的 头 元 素 。 


非 阻塞 行为 
当 BLPOP 被 调用 时 ， 如 果 给 定 key 内 至 少 有 一 个 非 空 列表 ， 那 么 弹出 遇 到 的 第 


一 个 非 空 列表 的 头 元 素 ， 并 和 被 弹出 元 素 所 属 的 列表 的 名 字 一 起 ， 组 成 结果 返回 给 
调用 者 。 


当 存 在 多 个 给 定 key 时 ， BLPOP RAE key 参数 排列 的 先后 顺序 ， 依 次 检查 
各 个 列表 。 


假设 现在 有 job 、 command 和 request 三 个 列表 ， 其 中 job KE, 
command 和 request 都 持 有 非 空 列表 。 考 虑 以 下 命令 : 


BLPOP job command request 0 


BLPOP 保证 返回 的 元 素来 自 command ， 因 为 它 是 按 " 查 找 job -> AK 
command -> 查找 request “这 样 的 顺序 ， 第 一 个 找到 的 非 空 列表 。 


redis> DEL job command request # 确保 key 都 被 删除 
(integer) 0 


redis> LPUSH command "update system..." # 为 Command 列 表 增 加 一 个 值 
(integer) 1 


redis> LPUSH request "visit page" # 为 request 列 表 增 加 一 个 值 
(integer) 1 


redis> BLPOP job command request 0 job 列表 为 空 ， 被 跳 过 ， BRE 


# 
1) "command" # 弹出 元 素 所 属 的 列表 
# 弹出 元 素 所 属 的 值 


2) “update system..." 
al = 
阻塞 行为 
如 果 所 有 给 定 key 都 不 存在 或 包含 空 列表 ， 那 么 BLPOP 命令 将 阻塞 连接 ， 直 到 


等 待 超时 ， 或 有 另 一 个 客户 端 对 给 定 key 的 任意 一 个 执行 LPUSH 或 RPUSH 命 
3A IE. 





超时 参数 timeout 接受 一 个 以 秒 为 单位 的 数字 作为 值 。 超 时 参数 设 为 0 表示 
阻塞 时 间 可 以 无 限期 延长 (block indefinitely) 。 


redis> EXISTS job # 确保 两 个 key 都 不 存在 
(integer) 0 

redis> EXISTS command 

(integer) 0 


redis> BLPOP job command 300 # 因为 key 一 开始 不 存在 ， 所 以 操作 会 被 阻塞 
1) "job" # 这 里 被 push 的 是 job 

2) "do my home work" # 被 弹出 的 值 

(26.26s) # 等 待 的 秒 数 

redis> BLPOP job command 5 # 等 待 超时 的 情况 

(nil) 


(5.66s) # 等 待 的 秒 数 
"| = = = E 
相同 的 key 被 多 个 客户 端 同时 阻塞 
相同 的 key 可 以 被 多 个 客户 端 同时 阻塞 。 


不 同 的 客户 端 被 放 进 一 个 队列 中 ， 按 『 先 阻塞 先 服务 」 (first-BLPOP，first-served) 
的 顺序 为 ”key 执行 BLPOP 命令 。 


在 MULTI/EXEC 事 务 中 的 BLPOP 

BLPOP 可 以 用 于 流水 线 (pipline, 批 量 地 发 送 多 个 命令 并 读 入 多 个 回复 )， 但 把 它 用 
在 MULTI/ EXEC 块 当中 没有 意义 。 因 为 这 要 求 整个 服务 器 被 阻塞 以 保证 块 执行 时 
的 原子 性 ， 该 行为 阻止 了 其 他 客户 端 执 行 LPUS 或 RPUSH tS. 


因此 ， 一 个 被 包 囊 在 MULTI / EXEC 块 内 的 BLPOP 命令 ， 行 为 表现 得 就 像 LPOP 
一 样 ， 对 空 列表 返回 nil ， 对 非 空 列表 弹出 列表 元 素 ， 不 进行 任何 阻塞 操作 。 





# 对 非 空 列表 进行 操作 


redis> RPUSH job programming 
(integer) 1 


redis> MULTI 
OK 


redis> BLPOP job 30 
QUEUED 


redis> EXEC # 不 阻塞 ， 立 即 返回 
1) 1) "job" 
2) "programming" 


# 对 空 列表 进行 操作 


redis> LLEN job # 空 列表 
(integer) 0 


redis> MULTI 
OK 


redis> BLPOP job 30 
QUEUED 


redis> EXEC # 不 阻塞 ， 立 即 返 回 
1) (nil) 
可 用 版 本 : 
>= 2.0.0 
时 间 复杂 度 : 
O(1) 
返回 值 : 
如 果 列 表 为 空 ， 返 回 一 个 nil 。 否 则 ， 返 回 一 个 含有 两 个 元 素 的 列表 ， 第 一 个 元 


素 是 被 洋 出 元 素 所 属 的 key ， 第 二 个 元 素 是 被 涡 出 元 素 的 值 。 
模式 : 事件 提醒 
有 时 候 ， 为 了 等 待 一 个 新 元 素 到 达 数 据 中 ， 需 要 使 用 轮 询 的 方式 对 数据 进行 探查 。 


另 一 种 更 好 的 方式 是 ， 使 用 系统 提供 的 阻塞 原 语 ， 在 新 元 素 到 达 时 立即 进行 处 理 ， 
而 新 元 素 还 没 到 达 时 ， 就 一 直 阻 塞 住 ， 避 免 轮 询 占用 资源 。 


对 于 Redis ， 我 们 似乎 需要 一 个 阻塞 版 的 SPOP 命令 ， 但 实际 上 ， 使 用 BLPOP 或 
者 BRPOP 就 能 很 好 地 解决 这 个 问题 。 


使 用 元 素 的 客户 端 (消费 者 ) 可 以 执行 类 似 以 下 的 代码 : 


LOOP forever 
WHILE SPOP(key) returns elements 
. process elements ... 
END 
BRPOP helper_key 
END 


添加 元 素 的 客户 端 (消费 者 ) 则 执行 以 下 代码 : 


MULTI 
SADD key element 
LPUSH helper_key x 
EXEC 


BRPOP 


BRPOP key [key ...] timeout 
BRPOP 是 列表 的 阻塞 式 (blocking) 弹 出 原 语 。 


它 是 RPOP 命 命 的 阻塞 版 本 ， 当 给 定 列表 内 没有 任何 元 素 可 供 弹 出 的 时 候 ， 连 接 将 
被 BRPOP 命令 阻塞 ， 直 到 等 待 超时 或 发 现 可 弹出 元 素 为 止 。 


当 给 定 多 个 key 参数 时 ， 按 参数 key 的 先后 顺序 依次 检查 各 个 列表 ， 弹 出 第 
一 个 非 空 列表 的 尾部 元 素 。 


关于 阻塞 操作 的 更 多 信息 ， 请 查看 BLPOP RS, BRPOP RT SHAAN 
BLPOP 不 同 之 外 ， 其 他 表现 一 致 。 


可 用 版 本 : 
>= 2.0.0 

at i SAE: 
O(1) 

返回 值 : 


假如 在 指定 时 间 内 没有 任何 元 素 被 弹出 ， 则 返回 一 个 nil 和 等 待 时 长 。 反 之 ， 返 
回 一 个 含有 两 个 元 素 的 列表 ， 第 一 个 元 素 是 被 弹出 元 素 所 属 的 key ， 第 二 个 元 素 
是 被 弹出 元 素 的 值 。 


redis> LLEN course 
(integer) 0 


redis> RPUSH course algorithm001 
(integer) 1 


redis> RPUSH course c++101 
(integer) 2 


redis> BRPOP course 30 
1) "course" H 被 弹出 元 素 所 属 的 列表 键 
2) "c++101" # 被 弹出 的 元 素 


BRPOPLPUSH 


BRPOPLPUSH source destination timeout 


BRPOPLPUSH 是 RPOPLPUSH 的 阻塞 版 本 ， 当 给 定 列表 source 不 为 空 时 ， 
BRPOPLPUSH 的 表现 和 RPOPLPUSH —#. 


当 列 表 source 为 空 时 ， BRPOPLPUSH 命令 将 阻塞 连接 ， 直 到 等 待 超时 ， 或 有 
另 一 个 客户 端 对 source 执行 LPUSH 或 RPUSH 命令 为 止 。 


超时 参数 timeout 接受 一 个 以 秒 为 单位 的 数字 作为 值 。 超 时 参数 设 为 ”9 表示 
阻塞 时 间 可 以 无 限期 延长 (block indefinitely) 。 


更 多 相关 信息 ， 请 参考 RPOPLPUSH AD- 
可 用 版 本 : 

>= 2.2.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 


假如 在 指定 时 间 内 没有 任何 元 素 被 弹出 ， 则 返回 一 个 nil 和 等 待 时 长 。 反 之 ， 返 
回 一 个 含有 两 个 元 素 的 列表 ， 第 一 个 元 素 是 被 弹出 元 素 的 值 ， 第 二 个 元 素 是 等 待 时 
Keo 


# 非 空 列表 

redis> BRPOPLPUSH msg reciver 500 

"hello moto" # 弹出 元 素 的 值 
(3.38s) # 等 待 时 长 


redis> LLEN reciver 
(integer) 1 


redis> LRANGE reciver © 0 
1) "hello moto" 


# 空 列表 
redis> BRPOPLPUSH msg reciver 1 


(nil) 
(1.34s) 


模式 : 安全 队列 


参考 RPOPLPUSH 命令 的 『 安 全 队列 上 模式 。 


模式 : 循环 列表 


参考 RPOPLPUSH ATH MARIRI 模式 。 


LINDEX 


LINDEX key index 
返回 列表 key 中 ， 下 标 为 index 的 元 素 。 


下 标 (index) 参 数 start 和 stop 都 以 o 为 底 ， 也 就 是 说 ， 以 0 表示 列表 
的 第 一 个 元 素 ， 以 1 表示 列表 的 第 二 个 元 素 ， 以 此 类 推 。 


你 也 可 以 使 用 负数 下 标 ， 以 -1 表示 列表 的 最 后 一 个 元 素 ， -2 表示 列表 的 倒数 
第 二 个 元 素 ， 以 此 类 推 。 


如 果 key 不 是 列表 类 型 ， 返 回 一 个 错误 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 


O(N), N 为 到 达 下 标 index 过 程 中 经 过 的 元 素数 量 。 因 此 ， 对 列表 的 头 元 素 
和 尾 元 素 执行 LINDEX AS, SEXON) 


返回 值 : 
列表 中 下 标 为 ”index 的 元 素 。 如 果 index 参数 的 值 不 在 列表 的 区 间 范 围 内 (out 
of range), RE] nil 。 

redis> LPUSH mylist "World" 

(integer) 1 


redis> LPUSH mylist "Hello" 
(integer) 2 


redis> LINDEX mylist 0 
"Hello" 


redis> LINDEX mylist -1 
"World" 


redis> LINDEX mylist 3 # index 不 在 mylist 的 区 间 范 围 内 
(nil) 


LINSERT 


LINSERT key BEFORE|AFTER pivot value 

将 值 value 插入 到 列表 key SH, UF pivot 之 前 或 之 后 。 
当 pivot 不 存在 于 列表 key 时 ， 不 执行 任何 操作 。 

当 key 不 存在 时 ， key 被 视 为 空 列表 ， 不 执行 任何 操作 。 

如 果 key 不 是 列表 类 型 ， 返 回 一 个 错误 。 

可 用 版 本 : 

>= 2.2.0 

时 间 复杂 度 : 

O(N), N 为 寻找 pivot 过 程 中 经 过 的 元 素数 量 。 

WB) fa: 


如 果 命 令 执 行 成 功 ， 返 回 插入 操作 完成 之 后 ， 列 表 的 长 度 。 如 果 没 有 找到 pivot 
, RE -1 。 如 果 key 不 存在 或 为 空 列表 ， 返 回 0 。 


redis> RPUSH mylist "Hello" 
(integer) 1 


redis> RPUSH mylist "World" 
(integer) 2 


redis> LINSERT mylist BEFORE "World" "There" 
(integer) 3 


redis> LRANGE mylist 0 -1 


1) "Hello" 
2) "There" 
3) "World" 


# 对 一 个 非 空 列表 插入 ， 坦 找 一 个 不 存在 的 pivot 


redis> LINSERT mylist BEFORE "go" "let's" 
(integer) -1 # 失败 


# 对 一 个 空 列表 执行 LINSERT 命令 


redis> EXISTS fake_list 
(integer) 0 


redis> LINSERT fake_list BEFORE "nono" "gogogog" 
(integer) 0 # 失败 


LLEN 


LLEN key 

返回 列表 key 的 长 度 。 
如 果 key 不 存在 ， 则 key 被 解释 为 一 个 空 列 表 ， 返 回 0 . 
如 果 key 不 是 列表 类 型 ， 返 回 一 个 错误 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

列表 key 的 长 度 。 


# 空 列表 


redis> LLEN job 
(integer) 0 


# 非 空 列表 


redis> LPUSH job "cook food" 
(integer) 1 


redis> LPUSH job "have lunch" 
(integer) 2 


redis> LLEN job 
(integer) 2 


LPOP 


LPOP key 

移 除 并 返回 列表 key 的 头 元 素 。 

可 用 版 本 : 

>= 1.0.0 

Bt a] RAE: 

O(1) 

返回 值 : 

列表 的 头 元 素 。 当 key 不 存在 时 ， 返 回 nil 。 
redis> LLEN course 
(integer) 0 


redis> RPUSH course algorithm001 
(integer) 1 


redis> RPUSH course c++101 
(integer) 2 


redis> LPOP course # BRATR 
"algorithmooi" 


LPUSH 


LPUSH key value [value ...] 
将 一 个 或 多 个 值 value 插入 到 列表 key WRK 


如 果 有 多 个 value 值 ， 那 么 各 个 value 值 按 从 左 到 右 的 顺序 依次 插入 到 表 
k: 比如 说 ， 对 空 列表 mylist 执行 命令 LPUSH mylist abc ， 列 表 的 值 将 
是 cha ， 这 等 同 于 原子 性 地 执行 LPUSH mylist a 、 LPUSH mylist b 

和 LPUSH mylist c 三 个 命令 。 


如 果 key 不 存在 ， 一 个 空 列表 会 被 创建 并 执行 LPUSH 操作 。 
当 key 存在 但 不 是 列表 类 型 时 ， 返 回 一 个 错误 。 

Note 

{Redis 2.4 版 本 以 前 的 LPUSH 命令 ， 都 只 接受 单个 value 值 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

执行 LPUSH 命令 后 ， 列 表 的 长 度 。 


# 加 入 单个 元 素 


redis> LPUSH languages python 
(integer) 1 


# 加 入 重复 元 素 


redis> LPUSH languages python 
(integer) 2 


redis> LRANGE languages 0 -1 
1) "python" 
2) "python" 


# 加 入 多 个 元 素 


redis> LPUSH mylist a bc 
(integer) 3 


redis> LRANGE mylist 0 -1 
1) Wi 
2) wm 
3) wam 


# 列表 人 允许 重复 元 素 


LRANGE 


LRANGE key start stop 
返回 列表 key 中 指定 区 间 内 的 元 素 ， 区 间 以 偏 移 量 start 和 stop 指定 。 


下 标 (index) 参 数 start 和 stop 都 以 o 为 底 ， 也 就 是 说 ， 以 0 表示 列表 
的 第 一 个 元 素 ， 以 1 表示 列表 的 第 二 个 元 素 ， 以 此 类 推 。 


你 也 可 以 使 用 负数 下 标 ， 以 -1 表示 列表 的 最 后 一 个 元 素 ， -2 表示 列表 的 倒数 
第 二 个 元 素 ， 以 此 类 推 。 


注意 LRANGE 命 信和 编程 语言 区 间 画 数 的 区 别 


假如 你 有 一 个 包含 一 百 个 元 素 的 列表 ， 对 该 列表 执行 LRANGE list 6 10 ， 结 果 

是 一 个 包含 11 个 元 素 的 列表 ， 这 表明 stop 下 标 也 在 LRANGE 命令 的 取 值 范 围 

之 内 ( 闭 区 间 )， 这 和 某 些 语言 的 区 间 豆 数 可 能 不 一 致 ， 比 如 Ruby 的 Range.new 
Array#slice 和 Python 的 range() WAX. 


超出 范围 的 下 标 
超出 范围 的 下 标 值 不 会 引起 错误 。 


如 果 start 下 标 比 列表 的 最 大 下 标 end ( LLEN list RA 1 ) 还 要 大 ， 那 
么 LRANGE 返回 一 个 空 列表 。 


如 果 stop 下 标 比 end 下 标 还 要 大 ，Redis 将 stop 的 值 设置 为 end 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(S+N) s 为 偏 移 量 start, N 为 指定 区 间 内 元 素 的 数量 。 

返回 值 : 

一 个 列表 ， 包 含 指定 区 间 内 的 元 素 。 


redis> RPUSH fp-language lisp 
(integer) 1 


redis> LRANGE fp-language 0 0 
1) "lisp" 


redis> RPUSH fp-language scheme 
(integer) 2 


redis> LRANGE fp-language © 1 
lS 
2) "scheme" 


LREM 


LREM key count value 
根据 参数 count 的 值 ， 移 除 列 表 中 和 与 参数 value 相等 的 元 素 。 
count 的 值 可 以 是 以 下 几 种 : 
e count &gt; 0 : 从 表 头 开始 向 表 尾 搜索 ， 移 除 与 value 相等 的 元 素 ， 数 


量 为 count 。 

e count &lt; 0 : 从 表 尾 开始 向 表 头 搜索 ， 移 除 与 value 相等 的 元 素 ， 数 
=A count 的 绝对 值 。 

e count = 0 : 移 除 表 中 所 有 与 value 相等 的 值 。 


可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(N), AN 为 列表 的 长 度 。 
返回 值 : 


被 移 除 元 素 的 数量 。 因 为 不 存在 的 key 被 视 作 空 表 (empty list)， 所 以 当 key 不 
存在 时 ， LREM 命令 总 是 返回 0 。 


# 先 创建 一 个 表 ， 内 容 排列 是 


# morning hello morning helllo morning 


redis> LPUSH greet "morning" 
(integer) 1 

redis> LPUSH greet "hello" 
(integer) 2 

redis> LPUSH greet "morning" 
(integer) 3 

redis> LPUSH greet "hello" 
(integer) 4 

redis> LPUSH greet "morning" 
(integer) 5 


redis> LRANGE greet 0 4 
1) "morning" 


2) "hello" 
3) "morning" 
4) "hello" 


5) "morning" 


redis> LREM greet 2 morning 
(integer) 2 


redis> LLEN greet 
(integer) 3 


redis> LRANGE greet 0 2 
1) "hello" 

2) "hello" 

3) "morning" 


redis> LREM greet -1 morning 
(integer) 1 


redis> LLEN greet 
(integer) 2 


redis> LRANGE greet 0 1 
1) "hello" 
2) “hello" 


redis> LREM greet 0 hello 
(integer) 2 


redis> LLEN greet 
(integer) 0 


# 查看 所 有 元 素 


# 移 除 从 表 头 到 表 尾 ， 最 先 发 现 的 两 个 morni 
# 两 个 元 素 被 移 除 


# 还 剩 3 个 元 素 


# 移 除 从 表 尾 到 表 头 ， 第 一 个 morning 


# 剩 下 两 个 元 素 


# 移 除 表 中 所 有 hello 
# 两 个 hello 被 移 除 











LSET 


LSET key index value 
将 列表 key 下 标 为 index 的 元 素 的 值 设置 为 value o 
当 index 参数 超出 范围 ， 或 对 一 个 空 列表 ( key 不 存在 ) 进 行 LSET 时 ， 返 回 一 


个 错误 。 

关于 列表 下 标的 更 多 信息 ， 请 参考 LINDEX 命令 。 
可 用 版 本 : 

>= 1.0.0 

By ja] SARE: 


对 头 元 素 或 尾 元 素 进 行 LSET 操作 ， 复 条 度 为 O(1)。 其 他 情况 下 ， 为 OIN)， N 
为 列表 的 长 度 。 


返回 值 : 
操作 成 功 返 回 ok ， 否 则 返回 错误 信息 。 


# 对 空 列表 (key 不 存在 ) 进 行 LSET 


redis> EXISTS list 
(integer) 0 


redis> LSET list 0 item 
(error) ERR no such key 


# 对 非 空 列表 进行 LSET 


redis> LPUSH job "cook food" 
(integer) 1 


redis> LRANGE job 0 0 
1) "cook food" 


redis> LSET job © "play game" 
OK 


redis> LRANGE job 0 0 
1) "play game" 


# index 超出 范围 


redis> LLEN list 
(integer) 1 


redis> LSET list 3 'out of range' 
(error) ERR index out of range 


# 列表 长 度 为 1 


LTRIM 


LTRIM key start stop 


对 一 个 列表 进行 修剪 (trim)， 就 是 说 ， 让 列表 只 保留 指定 区 间 内 的 元 素 ， 不 在 指定 区 
间 之 内 的 元 素 都 将 被 删除 。 


举 个 例子 ， 执 行 命令 LTRIM list 0 2 ， 表 示 只 保留 列表 list 的 前 三 个 元 
素 ， 其 余 元 素 全 部 删除 。 


下 标 (index) 参 数 start 和 stop 都 以 0 为 底 ， 也 就 是 说 ， 以 0 表示 列表 
的 第 一 个 元 素 ， 以 1 表示 列表 的 第 二 个 元 素 ， 以 此 类 推 。 


你 也 可 以 使 用 负数 下 标 ， 以 -1 表示 列表 的 最 后 一 个 元 素 ， -2 表示 列表 的 倒数 
第 二 个 元 素 ， 以 此 类 推 。 


当 key 不 是 列表 类 型 时 ， 返 回 一 个 错误 。 
LTRIM 命令 通常 和 LPUSH 命令 或 RPUSH 命令 配合 使 用 ， 举 个 例子 : 


LPUSH log newest_log 
LTRIM log © 99 


这 个 例子 模拟 了 一 个 日 志 程序 ， 每 次 将 最 新 日 志 newest_log ME log WH 

中 ， 并 且 只 保留 最 新 的 100 项 。 注 意 当 这 样 使 用 LTRIM 命令 时 ， 时 间 复 条 度 

是 O(1)， 因 为 平均 情况 下 ， 每 次 只 有 一 个 元 素 被 移 除 。 

注意 LTRIM 命 合 和 编程 语言 区 间 男 数 的 区 别 

假如 你 有 一 个 包含 一 百 个 元 素 的 列表 list ， 对 该 列表 执行 LTRIM list 0 10 

， 结 果 是 一 个 包含 11 个 元 素 的 列表 ， 这 表明 stop 下 标 也 在 LTRIM 命令 的 取 值 范 

围 之 内 ( 闭 区 间 )， 这 和 某 些 语言 的 区 间 画 数 可 能 不 一 致 ， 比 如 Ruby 的 Range .new 
Array#slice 和 Python 的 range() WX. 

超出 范围 的 下 标 

超出 范围 的 下 标 值 不 会 引起 错误 。 

如 果 start 下 标 比 列表 的 最 大 下 标 end ( LLEN list RHA 1 ) 还 要 大 ， 或 


者 start &gt; stop ，LTRIM 返回 一 个 空 列表 (因为 LTRIM 已 经 将 整个 列表 清 


空 )。 


如 果 stop 下 标 比 end 下 标 还 要 大 ，Redis 将 stop 的 值 设置 为 end o 
可 用 版 本 : 
>= 1.0.0 


时 间 复杂 度 : 

O(N), N 为 被 移 除 的 元 素 的 数量 。 
WO) fa: 

命令 执行 成 功 时 ， 返 回 ok 。 


# 情况 1: 常见 情况 ， start 和 stop 都 在 列表 的 索引 范围 之 内 


redis> LRANGE alpha © -1 # alpha 是 一 个 包含 5 个 字符 串 的 列表 
1) We 

2) eu 

3) MAN 

4) Uy 

5) TOS 

redis> LTRIM alpha 1 -1 # WIR alpha 列表 索引 为 0 的 元 素 
OK 

redis> LRANGE alpha © -1 # "h" 被 删除 了 

1) Well 

2) Uy E 

3) [oe 

4) VON 


# 情况 2: stop 比 列表 的 最 大 下 标 还 要 大 


redis> LTRIM alpha 1 10086 # 保留 alpha 列表 索引 1 至 索引 10086 上 
OK 

redis> LRANGE alpha © -1 # 只 有 索引 0 上 的 元 素 "e" 被 删除 了 ， 其 他 : 
19) Wa Ba 

2) ue | AW 

3) WON 


# 情况 3: start 和 stop 都 比 列表 的 最 大 下 标 要 大 ， 并 且 start < stop 


redis> LTRIM alpha 10086 123321 
OK 


redis> LRANGE alpha © -1 # 列表 被 清空 
(empty list or set) 


# 情况 4: start 和 stop 都 比 列表 的 最 大 下 标 要 大 ， 并 且 start > stop 


redis> RPUSH new-alpha "h" "e" "1" "1" "o" # 重新 建立 一 个 新 列表 
(integer) 5 


redis> LRANGE new-alpha 0 -1 
1) UW ia 
2) Wea 
3) Mae 


4) WAL 
5) Wot! 


redis> LTRIM new-alpha 123321 10086 
OK 


redis> LRANGE new-alpha 0 -1 
(empty list or set) 


# 执行 LTRIM 


# 同样 被 清空 








RPOP 


RPOP key 
移 除 并 返回 列表 key 的 尾 元 素 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

Wl) 4a : 


列表 的 尾 元 素 。 当 key 不 存在 时 ， 


redis> RPUSH mylist "one" 
(integer) 1 


redis> RPUSH mylist "two" 
(integer) 2 


redis> RPUSH mylist "three" 
(integer) 3 


redis> RPOP mylist 
"three" 


redis> LRANGE mylist 0 -1 
1) "one" 
2) "two" 


返回 nil 。 


# 返回 被 弹出 的 元 素 


# 列表 剩 下 的 元 素 


RPOPLPUSH 


RPOPLPUSH source destination 
mD RPOPLPUSH 在 一 个 原子 时 间 内 ， 执 行 以 下 两 个 动作 : 


。 将 列表 source 中 的 最 后 一 个 元 素 ( 尾 元 素 ) 漳 出 ， 并 返回 给 客户 端 。 
e 将 source 弹出 的 元 素 插 入 到 列表 destination ， 作 为 destination 
列表 的 的 头 元 素 。 


举 个 例子 ， 你 有 两 个 列表 source 和 destination , source 列表 有 元 素 
a, b, c ， destination 列表 有 元 素 x，y，z ， 执 行 

RPOPLPUSH source destination 之 后 ， source 列表 包含 元 素 a, b, 
destination 列表 包含 元 素 c，x，y，z ， 并 且 元 素 c 会 被 返回 给 客户 端 。 


如 果 source 不 存在 ， 值 nil 被 返回 ， 并 且 不 执行 其 他 动作 。 


如 果 source 和 destination 相同 ， 则 列表 中 的 表 尾 元 素 被 移动 到 表 头 ， 并 返 
回 该 元 素 ， 可 以 把 这 种 特殊 情况 视 作 列表 的 旋转 (rotation) 操 作 。 


可 用 版 本 : 
>= 1.2.0 

时 间 复 条 度 : 
O(1) 

返回 值 : 

被 弹出 的 元 素 。 


# source 和 destination 不 同 


redis> LRANGE alpha © -1 # 查看 所 有 元 素 
1) ale 
2) wpa 
3) Wes 
4) wau 


redis> RPOPLPUSH alpha reciver # 执行 一 次 RPOPLPUSH 看 看 
waits 


redis> LRANGE alpha 0 -1 


1) WA 
2) Uy gyi 
3) Welt 


redis> LRANGE reciver 0 -1 
1) watt 


redis> RPOPLPUSH alpha reciver # 再 执行 一 次 ， 证 实 RPOP 和 LPUSH 的 位 
Wie 


redis> LRANGE alpha © -1 


1) Wa 
2) Wins 
redis> LRANGE reciver 0 -1 
1) eu 
2) Wyo | 


# source 和 destination 相同 


redis> LRANGE number 0 -1 


1) Wig |e 

2) Wie 

3) Wy 

4) Wa 

redis> RPOPLPUSH number number 

i T 

redis> LRANGE number © -1 # 4 被 旋转 到 了 表 头 
1) wA 

2) ia RA 

3) Wop 

4) Wal! 

redis> RPOPLPUSH number number 

WaN 

redis> LRANGE number 9 -1 # 这 次 是 3 被 旋转 到 了 表 头 
1) WM 

2) UAN 

3) Ws aN 

4) WN 





模式 : 安全 的 队列 


Redis 的 列表 经 常 被 用 作 队 列 (queue)， 用 于 在 不 同 程序 之 间 有 序 地 交换 消息 
(message)。 一 个 客户 端 通过 LPUSH 命令 将 消息 放 入 队列 中 ， 而 另 一 个 客户 端 通 
at RPOP 或 者 BRPOP 命令 取出 队列 中 等 待 时 间 最 长 的 消息 。 


不 笠 的 是 ， 上 面 的 队列 方法 是 『 不 安全 4 的 ， 因 为 在 这 个 过 程 中 ， 一 个 客户 端 可 能 
在 取出 一 个 消息 之 后 崩溃 ， 而 未 义理 完 的 消息 也 就 因此 丢失 。 


使 用 RPOPLPUSH 命令 (或 者 它 的 阻塞 版 本 BRPOPLPUSH ) 可 以 解决 这 个 问题 : 
因为 它 不 仅 返 回 一 个 消息 ， 同 时 还 将 这 个 消息 添加 到 另 一 个 备份 列表 当中 ， 如 果 一 
切 正 常 的 话 ， 当 一 个 客户 端 完 成 某 个 消息 的 义理 之 后 ， 可 以 用 LREM 命令 郊 这 个 消 
息 从 各 份 表 删 除 。 


最 后 ， 还 可 以 添加 一 个 客户 端 专门 用 于 监视 各 份 表 ， 它 自动 地 将 超过 一 定 处 理 时 限 
的 消息 重新 放 和 人 队列 中 去 (负责 处 理 该 消息 的 客户 端 可 能 已 经 骨 溃 )， 这 样 就 不 会 丢 
失 任 何 消息 了 。 


模式 : 循环 列表 


通过 使 用 相同 的 key 作为 RPOPLPUSH 命令 的 两 个 参数 ， 客 户 端 可 以 用 一 个 接 
一 个 地 获取 列表 元 素 的 方式 ， 取 得 列表 的 所 有 元 素 ， 而 不 必 像 LRANGE 命令 那 祥 
一 下 子 将 所 有 列表 元 素 都 从 服务 器 传送 到 客户 端 中 (两 种 方式 的 总 复杂 度 都 是 
O(N))。 


以 上 的 模式 甚至 在 以 下 的 两 个 情况 下 也 能 正常 工作 : 


。 有 多 个 客户 端 同 时 对 同一 个 列表 进行 旋转 (rotating)， 它 们 获取 不 同 的 元 素 ， 直 
到 所 有 元 素 都 被 读 取 完 ， 之 后 又 从 头 开始 。 
。 有 客户 端 在 向 列表 尾部 (右边 ) 添 加 新 元 素 。 


这 个 模式 使 得 我 们 可 以 很 容易 实现 这 样 一 类 系统 : 有 N 个 客户 端 ， 需 要 连续 不 断 地 
对 一 些 元 素 进 行 处 理 ， 而 且 处 理 的 过 程 必 须 尽 可 能 地 快 。 一 个 典型 的 例子 就 是 服务 
器 的 监控 程序 : 它们 需要 在 尽 可 能 短 的 时 间 内 ， 并 行 地 检查 一 组 网 站 ， 确 保 它们 的 
可 访问 性 。 

注意 ， 使 用 这 个 模式 的 客户 端 是 易于 扩展 (scala) 且 安全 (reliable) 的 ， 因 为 就 算 接 收 
到 元 素 的 客户 端 失败 ， 元 素 还 是 保存 在 列表 里 面 ， 不 会 丢失 ， 等 到 下 个 迭代 来 临 的 
时 候 ， 别 的 客户 端 又 可 以 继续 处 理 这 些 元 素 了 。 


RPUSH 


RPUSH key value [value ...] 
将 一 个 或 多 个 值 value 插入 到 列表 key 的 表 尾 (最 右边 )。 


如 果 有 多 个 value 值 ， 那 么 各 个 value 值 按 从 左 到 右 的 顺序 依次 插入 到 表 
尾 : 比如 对 一 个 空 列表 mylist 执行 RPUSH mylist a b c ， 得 出 的 结果 列表 
为 abc ， 等 同 于 执行 命令 RPUSH mylist a 、 RPUSH mylist b 、 
RPUSH mylist c 。 


如 果 key 不 存在 ， 一 个 空 列表 会 被 创建 并 执行 RPUSH 操作 。 

当 key 存在 但 不 是 列表 类 型 时 ， 返 回 一 个 错误 。 

Note 

在 Redis 2.4 版 本 以 前 的 RPUSH 命令 ， 都 只 接受 单个 value 值 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

Wola : 

执行 RPUSH 操作 后 ， 表 的 长 度 。 


# 添加 单个 元 素 


redis> RPUSH languages c 
(integer) 1 


# 添加 重复 元 素 


redis> RPUSH languages c 
(integer) 2 


redis> LRANGE languages 0 -1 # 列表 允许 重复 元 素 
1) WEN 
2) ou 


# 添加 多 个 元 素 


redis> RPUSH mylist a bc 
(integer) 3 


redis> LRANGE mylist 0 -1 
1) Wa 
2) bi 
3) TON 


RPUSHX 


RPUSHX key value 

将 值 value 插入 到 列表 key DRE, SHRM key 存在 并 且 是 一 个 列表 。 
和 RPUSH 命令 相反 ， 当 key 不 存在 时 ， RPUSHX 命令 什么 也 不 做 。 

可 用 版 本 : 

>= 2.2.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

RPUSHX 命令 执行 之 后 ， 表 的 长 度 。 


# key 不 存在 


redis> LLEN greet 
(integer) 0 


redis> RPUSHX greet "hello" # 对 不 存在 的 key 进行 RPUSHX, PUSH 失 ; 
(integer) 0 


# key 存在 且 是 一 个 非 空 列表 


redis> RPUSH greet "hi" # 先 用 RPUSH 插入 一 个 元 素 
(integer) 1 


redis> RPUSHX greet "hello" # greet 现在 是 一 个 列表 类 型 ，RPUSHX 操作 
(integer) 2 


redis> LRANGE greet 0 -1 
1) Waa 
2) "hello" 





Set (#4) 


SADD 


SADD key member [member ...] 


将 一 个 或 多 个 member 元 素 加 入 到 集合 key 当中 ， 已 经 存在 于 集合 的 
member 元 素 将 被 忽略 。 


假如 key 不 存在 ， 则 创建 一 个 只 包含 member 元 素 作 成 员 的 集合 。 


当 key 不 是 集合 类 型 时 ， 返 回 一 个 错误 。 


Note 

在 Redis2.4 版 本 以 前 ， SADD 只 接受 单个 member 值 。 
可 用 版 本 : 

>= 1.0.0 


时 间 复杂 度 : 

O(N), N 是 被 添加 的 元 素 的 数量 。 

返回 值 : 

被 添加 到 集合 中 的 新 元 素 的 数量 ， 不 包括 被 忽略 的 元 素 。 


# 添加 单个 元 素 


redis> SADD bbs "discuz.net" 
(integer) 1 


# 添加 重复 元 素 


redis> SADD bbs "discuz.net" 
(integer) 0 


# 添加 多 个 元 素 


redis> SADD bbs "tianya.cn" "groups.google.com" 
(integer) 2 


redis> SMEMBERS bbs 

1) "discuz.net" 

2) "groups.google.com" 
3) "tianya.cn" 


SCARD 


SCARD key 

返回 集合 key 的 基数 (集合 中 元 素 的 数量 )。 

可 用 版 本 : 

>= 1.0.0 

时 间 复杂 度 : 

O(1) 

返回 值 : 

集合 的 基数 。 当 key REN, RE o- 
redis> SADD tool pc printer phone 
(integer) 3 


redis> SCARD tool # 非 空 集合 
(integer) 3 


redis> DEL tool 
(integer) 1 


Ob 


redis> SCARD tool # 空 集 
(integer) 0 


SDIFF 


SDIFF key [key ...] 
返回 一 个 集合 的 全 部 成 员 ， 该 集合 是 所 有 给 定 集合 之 间 的 差 集 。 
不 存在 的 key 被 视 为 空 集 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(N), N 是 所 有 给 定 集合 的 成 员 数 量 之 和 。 


WRB) (a: 
一 个 包含 差 集 成 员 的 列表 。 
redis> SMEMBERS peter's movies 
1) "bet man" 
2) "start war" 
3) "2012" 
redis> SMEMBERS joe's movies 
1) "hi, lady" 
2) "Fast Five" 
3) "2012" 


redis> SDIFF peter's_movies joe's_movies 
1) "bet man" 
2) "start war" 


SDIFFSTORE 


SDIFFSTORE destination key [key ...] 


这 个 命令 的 作用 和 SDIFF 类 似 ， 但 它 将 结果 保存 到 destination 集合 ， 而 不 


简单 地 返回 结果 集 。 

如 果 destination 集合 已 经 存在 ， 则 将 其 覆盖 。 
destination 可 以 是 key 本 身 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复杂 度 : 


WRB) fa 
结果 集中 的 元 素数 量 。 
redis> SMEMBERS joe's_movies 
1) "hi, lady" 
2) "Fast Five" 
3) "2012" 
redis> SMEMBERS peter's_movies 
1) "bet man" 
2) "start war" 
3) "2012" 


redis> SDIFFSTORE joe_diff_peter joe's_movies 
(integer) 2 


redis> SMEMBERS joe_diff_peter 
1) "hi, lady" 
2) "Fast Five" 


peter's_movies 


SINTER 


SINTER key [key ...] 
返回 一 个 集合 的 全 部 成 员 ， 该 集合 是 所 有 给 定 集合 的 交集 。 
不 存在 的 key 被 视 为 空 集 。 
当 给 定 集合 当中 有 一 个 空 集 时 ， 结 果 也 为 空 集 (根据 集合 运算 定律 )。 
可 用 版 本 : 
>= 1.0.0 
时 间 复 条 度 : 
O(N*M), AN 为 给 定 集合 当中 基数 最 小 的 集合 ， M 为 给 定 集合 的 个 数 。 
WRB) (a: 
交集 成 员 的 列表 。 
redis> SMEMBERS group_1 
1) SEE Er 
2) "TOM" 
3) "JACK" 
redis> SMEMBERS group_2 
1) "HAN MEIMEI" 
2) "JACK" 


redis> SINTER group_1 group_2 
1) "JACK" 


SINTER 


SINTER key [key ...] 
返回 一 个 集合 的 全 部 成 员 ， 该 集合 是 所 有 给 定 集合 的 交集 。 
不 存在 的 key 被 视 为 空 集 。 
当 给 定 集合 当中 有 一 个 空 集 时 ， 结 果 也 为 空 集 (根据 集合 运算 定律 )。 
可 用 版 本 : 
>= 1.0.0 
时 间 复 条 度 : 
O(N*M), AN 为 给 定 集合 当中 基数 最 小 的 集合 ， M 为 给 定 集合 的 个 数 。 
WRB) (a: 
交集 成 员 的 列表 。 
redis> SMEMBERS group_1 
1) SEE Er 
2) "TOM" 
3) "JACK" 
redis> SMEMBERS group_2 
1) "HAN MEIMEI" 
2) "JACK" 


redis> SINTER group_1 group_2 
1) "JACK" 


SINTERSTORE 


SINTERSTORE destination key [key ...] 


这 个 命令 类 似 于 SINTER 命令 ， 但 它 将 结果 保存 到 destination 集合 ， 而 不 是 
简单 地 返回 结果 集 。 


如 果 destination 集合 已 经 存在 ， 则 将 其 履 盖 。 
destination 可 以 是 key 本 身 。 
可 用 版 本 : 


O(N*M) AN 为 给 定 集合 当中 基数 最 小 的 集合 ， M 为 给 定 集合 的 个 数 。 


结果 集中 的 成 员 数 量 。 


redis> SMEMBERS songs 
1) "good bye joe" 
2) “hello, peter" 


redis> SMEMBERS my_songs 
1) "good bye joe" 
2) "falling" 


redis> SINTERSTORE song_interset songs my_songs 
(integer) 1 


redis> SMEMBERS song_interset 
1) "good bye joe" 


SISMEMBER 


SISMEMBER key member 

判断 member 元 素 是 否 集合 key 的 成 员 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

退回 值 : 

如 果 member 元 素 是 集合 的 成 员 ， 返 回 1 。 如 果 member 元 素 不 是 集合 的 成 
员 ， 或 key PEE, WE 0 。 


redis> SMEMBERS joe's_movies 


1) "hi, lady" 
2) "Fast Five" 
3) "2012" 


redis> SISMEMBER joe's_movies "bet man" 
(integer) 0 


redis> SISMEMBER joe's_movies "Fast Five" 
(integer) 1 


SMEMBERS 


SMEMBERS key 

返回 集合 key 中 的 所 有 成 员 。 
不 存在 的 key 被 视 为 空 集合 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(N), AN 为 集合 的 基数 。 
WO) fa: 

集合 中 的 所 有 成 员 。 


# key 不 存在 或 集合 为 空 


redis> EXISTS not_exists_key 
(integer) 0 


redis> SMEMBERS not_exists_key 
(empty list or set) 


# 非 空 集合 


redis> SADD language Ruby Python Clojure 
(integer) 3 


redis> SMEMBERS language 
1) "Python" 

2) "Ruby" 

3) "Clojure" 


SMOVE 


SMOVE source destination member 
将 member WRM source 集合 移动 到 destination 集合 。 
SMOVE 是 原子 性 操作 。 


如 果 source 集合 不 存在 或 不 包含 指定 的 member WR, N) SMOVE 命令 不 执 
行 任何 操作 ， 仅 返回 o o GA, member WRM source 集合 中 被 移 除 ， 并 
添加 到 destination 集合 中 去 。 


当 destination 集合 已 经 包含 member 元 素 时 ， SMOVE 命令 只 是 简单 地 将 
source 集合 中 的 member 元 素 删 除 。 


当 source 或 destination 不 是 集合 类 型 时 ， 返 回 一 个 错误 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

如 果 member 元 素 被 成 功 移 除 ， 返 回 1 。 如 果 member 元 素 不 是 source 
集合 的 成 员 ， 并 且 没 有 任何 操作 对 destination 集合 执行 ， 那 么 返回 9 。 


redis> SMEMBERS songs 
1) "Billie Jean" 
2) "Believe Me" 


redis> SMEMBERS my_songs 
(empty list or set) 


redis> SMOVE songs my_songs "Believe Me" 
(integer) 1 


redis> SMEMBERS songs 
1) "Billie Jean" 


redis> SMEMBERS my_songs 
1) "Believe Me" 


SPOP 


SPOP key 
移 除 并 返回 集合 中 的 一 个 随机 元 素 。 


如 果 只 想 获 取 一 个 随机 元 素 ， 但 不 想 该 元 素 从 集合 中 被 移 除 的 话 ， 可 以 使 用 
SRANDMEMBER #743. 


可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

被 移 除 的 随机 元 素 。 当 key 不 存在 或 key 是 空 集 时 ， 返 回 nil 。 


redis> SMEMBERS db 


1) "MySQL" 
2) "MongoDB" 
3) "Redis" 


redis> SPOP db 
"Redis" 


redis> SMEMBERS db 
1) "MySQL" 
2) "MongoDB" 


redis> SPOP db 
" MySQL" 


redis> SMEMBERS db 
1) "MongoDB" 


SRANDMEMBER 


SRANDMEMBER key [count] 
如 果 命 令 执 行 时 ， 只 提供 了 key 参数， 那么 返回 集合 中 的 一 个 随机 元 素 。 
从 Redis 2.6 版 本 开始 ， SRANDMEMBER 命令 接受 可 选 的 _ count BRM: 


e 如 果 count 为 正 数 ， 且 小 于 集合 基数 ， 那 么 命令 返回 一 个 包含 count 个 
数组 中 的 元 素 各 不 相同 。 如 果 count 大 于 等 于 集合 基数 ， 那 么 

e 如 果 ， te Dh 数 ， 那 么 命令 返回 一 个 数组 ， 数 组 中 的 元 素 可 能 会 重复 出 现 
多 次 ， 而 数组 的 长 度 为 count 的 绝对 值 。 


该 操作 和 SPOP 相似 ， 但 SPOP 将 随机 元 素 从 集合 中 移 除 并 返回 ， 而 
SRANDMEMBER 则 仅仅 返回 随机 元 素 ， 而 不 对 集合 进行 任何 改动 。 


可 用 版 本 : 
>= 1.0.0 
时 间 复 条 度 : 


只 提供 ”key 参数 时 为 DO(1) 。 如 果 提 供 了 count 参数， 那么 为 O(N), N Aik 
回 数组 的 元 素 个 数 。 


退回 值 : 
只 提供 key 参数 时 ， 返 回 一 个 元 素 ; 如 果 和 集合 为 空 ， 返 回 nil 。 如 果 提 供 了 


count 参数， So 如 果 集 合 为 空 ， 返 回 空 数组 。 


# 添加 元 素 


redis> SADD fruit apple banana cherry 
(integer) 3 


# 只 给 定 key 参数 ， 返 回 一 个 随机 元 素 


redis> SRANDMEMBER fruit 
"cherry" 


redis> SRANDMEMBER fruit 
"apple" 


# AT 3 为 count 参数 ， 返 回 3 个 随机 元 素 
# 每 个 随机 元 素 都 不 相同 


redis> SRANDMEMBER fruit 3 
1) "apple" 


2) "banana" 
3) "cherry" 


# 给 定 -3 为 count BR, ike] 3 个 随机 元 素 
# 元 素 可 能 会 重复 出 现 多 次 


redis> SRANDMEMBER fruit -3 
1) "banana" 


2) "cherry" 

3) "apple" 

redis> SRANDMEMBER fruit -3 
1) "apple" 

2) "apple" 

3) "cherry" 


# 如 果 count 是 整数 ， 且 大 于 等 于 集合 基数 ， 那 么 返回 整个 集合 


redis> SRANDMEMBER fruit 10 


1) "apple" 
2) "banana" 
3) "cherry" 


# 如 果 count 是 负数 ， 且 count 的 绝对 值 大 于 集合 的 基数 
# 那么 返回 的 数组 的 长 度 为 count 的 绝对 值 


redis> SRANDMEMBER fruit -10 
1) "banana" 


2) "apple" 
3) "banana" 
4) "cherry" 
5) "apple" 
6) "apple" 
7) "cherry" 
8) "apple" 
9) "apple" 


10) "banana" 

# SRANDMEMBER 并 不 会 修改 集合 内 容 
redis> SMEMBERS fruit 

1) "apple" 


2) "cherry" 
3) "banana" 


# 集合 为 空 时 返回 nil 或 者 空 数组 


redis> SRANDMEMBER not-exists 
(nil) 


redis> SRANDMEMBER not-eixsts 10 
(empty list or set) 
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SREM 


SREM key member [member ...] 


BREA key 中 的 一 个 或 多 个 _ member 元 素 ， 不 存在 的 member 元 素 会 被 忽 
略 。 


当 key 不 是 集合 类 型 ， 返 回 一 个 错误 。 


Note 

在 Redis 2.4 版 本 以 前 ， SREM 只 接受 单个 member 值 。 
可 用 版 本 : 

>= 1.0.0 


时 间 复 杂 度 : 

O(N), N 为 给 定 member 元 素 的 数量 。 
返回 值 : 

被 成 功 移 除 的 元 素 的 数量 ， 不 包括 被 忽略 的 元 素 。 


# 测试 数据 


redis> SMEMBERS languages 


1) WEU 

2) "lisp" 
3) "python" 
4) "ruby" 


# 移 除 单个 元 素 


redis> SREM languages ruby 
(integer) 1 


# 移 除 不 存在 元 素 


redis> SREM languages non-exists-language 
(integer) 0 


# 移 除 多 个 元 素 


redis> SREM languages lisp python c 
(integer) 3 


redis> SMEMBERS languages 
(empty list or set) 
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SUNION 


SUNION key [key ...] 
返回 一 个 集合 的 全 部 成 员 ， 该 集合 是 所 有 给 定 集合 的 并 集 。 
不 存在 的 key 被 视 为 空 集 。 
可 用 版 本 : 
>= 1.0.0 
时 间 复 条 度 : 
O(N), N 是 所 有 给 定 集合 的 成 员 数 量 之 和 。 
返回 值 : 
并 集成 员 的 列表 。 
redis> SMEMBERS songs 
1) "Billie Jean" 


redis> SMEMBERS my_songs 
1) "Believe Me" 


redis> SUNION songs my_songs 
1) "Billie Jean" 
2) "Believe Me" 


SUNIONSTORE 


SUNIONSTORE destination key [key ...] 


这 个 命令 类 似 于 SUNION 命令 ， 但 它 将 结果 保存 到 destination 
简单 地 返回 结果 集 。 


如 果 destination 已 经 存在 ， 则 将 其 覆盖 。 
destination 可 以 是 key 本 身 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 


AN 


吉 果 集中 的 元 素数 量 。 


redis> SMEMBERS NoSQL 
1) "MongoDB" 
2) "Redis" 


redis> SMEMBERS SQL 
1) "sqlite" 
2) "MySQL" 


redis> SUNIONSTORE db NoSQL SQL 
(integer) 4 


redis> SMEMBERS db 


1) "MySQL" 
2) "sqlite" 
3) "MongoDB" 


4) "Redis" 


SSCAN 


SSCAN key cursor [MATCH pattern] [COUNT count] 


详细 信息 请 参考 SCAN 命令 。 


SortedSet (有 序 集 合 ) 


ZADD 


ZADD key score member [[score member] [score member] ...] 
将 一 个 或 多 个 _ member 元 素 及 其 score 值 加 入 到 有 序 集 key 4H, 


如 果 某 个 member 已 经 是 有 序 集 的 成 员 ， 那 么 更 新 这 个 member BY score 
值 ， 并 通过 重新 插入 这 个 member 元 素 ， 来 保证 该 member 在 正确 的 位 置 上 。 


score 值 可 以 是 整数 值 或 双 精度 浮 点 数 。 

如 果 key 不 存在 ， 则 创建 一 个 空 的 有 序 集 并 执行 ZADD 操作 。 
4 key 存在 但 不 是 有 序 集 类 型 时 ， 返 回 一 个 错误 。 

对 有 序 集 的 更 多 介绍 请 参见 sorted set 。 


Note 

在 Redis 2.4 版 本 以 前 ，ZADD 每 次 只 能 添加 一 个 元 素 。 
可 用 版 本 : 

>= 1.2.0 


时 间 复 条 度 : 

O(M*log(N)), N 是 有 序 集 的 基数 ， M 为 成 功 添加 的 新 成 员 的 数量 。 
返回 值 : 

被 成 功 添 加 的 新 成 员 的 数量 ， 不 包括 那些 被 更 新 的 、 已 经 存在 的 成 员 。 


# 添加 单个 元 素 


redis> ZADD page_rank 10 google.com 
(integer) 1 


# 添加 多 个 元 素 


redis> ZADD page_rank 9 baidu.com 8 bing.com 
(integer) 2 


redis> ZRANGE page_rank © -1 WITHSCORES 
1) "bing.com" 


2) Wo 

3) "baidu.com" 
4) "o" 

5) "google.com" 
6) "410" 


# 添加 已 存在 元 素 ， 且 score 值 不 变 


redis> ZADD page_rank 10 google.com 
(integer) 0 


redis> ZRANGE page_rank © -1 WITHSCORES # 没有 改变 
1) "bing.com" 


2) we 

3) "baidu.com" 
4) wou 

5) "google.com" 
6) "10" 


# 添加 已 存在 元 素 ， 但 是 改变 score 值 


redis> ZADD page_rank 6 bing.com 
(integer) 0 


redis> ZRANGE page_rank © -1 WITHSCORES # bing.com 元 素 的 score 值 
1) "bing.com" 


2) We" 
3) "baidu.com" 
4) wou 


5) "google.com" 
6) "410" 





ZCARD 


ZCARD key 


WR 


可 


>= 


时 


回 有 序 集 key 的 基数 。 
用 版 本 : 

1.2.0 

间 复 杂 度 : 


O(1) 


WR 


4 ke 存在 且 是 有 序 集 类 型 时 ， 返 回 有 序 集 的 基数 。 当 key 不 存在 时 ， 返 回 


0 


回 值 : 


o 


redis > ZADD salary 2000 tom 
(integer) 1 


redis > ZCARD salary 
(integer) 1 


redis > ZADD salary 5000 jack 
(integer) 1 


redis > ZCARD salary 
(integer) 2 


redis > EXISTS non_exists_key 
(integer) 0 


redis > ZCARD non_exists_key 
(integer) 0 


# 添加 一 个 成 员 


# 再 添加 一 个 成 员 


# 对 不 存在 的 key 进行 ZCARD 操作 


ZCOUNT 


ZCOUNT key min max 


返回 有 序 集 key H, score 值 在 min 和 max 之 间 ( 黑 认 包括 score 值 
等 于 min 或 max ) 的 成 员 的 数量 。 


关于 参数 min 和 max 的 详细 使 用 方法 ， 请 参考 ZRANGEBYSCORE 命 合 。 
可 用 版 本 : 

>= 2.0.0 

时 间 复杂 度 : 

O(log(N)), N 为 有 序 集 的 基数 。 

返回 值 : 

score {E min 和 max 之 间 的 成 员 的 数量 。 


redis> ZRANGE salary © -1 WITHSCORES # 测试 数据 


1) "jack" 

2) "2000" 

3) "peter" 

4) "3500" 

5) "tom" 

6) "5000" 

redis> ZCOUNT salary 2000 5000 # 计算 薪水 在 2000-5000 之 间 的 


(integer) 3 


redis> ZCOUNT salary 3000 5000 # 计算 薪水 在 3000-5000 之 间 的 
(integer) 2 


Ki aay 





ZINCRBY 


ZINCRBY key increment member 
ABR key 的 成 员 member BY score 值 加 上 增 量 increment 。 


可 以 通过 传递 一 个 负数 值 increment , it score MAMMA, bean 
ZINCRBY key -5 member ， 就 是 让 member 的 score 值 减 去 5 。 


当 key 不 存在 , 或 member 不 是 key 的 成 员 时 ， 
ZINCRBY key increment member 等 同 于 ZADD key increment member 。 


4 key 不 是 有 序 集 类 型 时 ， 返 回 一 个 错误 。 

score 值 可 以 是 整数 值 或 双 精度 浮 点 数 。 

可 用 版 本 : 

>= 1.2.0 

时 间 复杂 度 : 

O(log(N)) 

返回 值 : 

member 成 员 的 新 score 值 ， 以 字符 串 形式 表示 。 


redis> ZSCORE salary tom 
"2000" 


redis> ZINCRBY salary 2000 tom # tom 加 薪 啦 ! 
"4000" 


ZRANGE 


ZRANGE key start stop [WITHSCORES] 
返回 有 序 集 key 中 ， 指 定 区 间 内 的 成 员 。 
其 中 成 员 的 位 置 按 score 值 递 增 (从 小 到 大 ) 来 排序 。 
具有 相同 score 值 的 成 员 按 字典 序 (lexicographical order ) 来 排列 。 
如 果 你 需要 成 员 按 score 值 递减 (从 大 到 小 ) 来 排列 ， 请 使 用 ZREVRANGE fà 


Do 


下 标 参 数 start 和 stop 都 以 o 为 底 ， 也 就 是 说 ， 以 0 表示 有 序 集 第 一 
成 员 ， 以 1 表示 有 序 集 第 二 个 成 员 ， 以 此 类 推 。 你 也 可 以 使 用 负数 下 标 ， 以 

-1 表示 最 后 一 个 成 员 ， -2 表示 倒数 第 二 个 成 员 ， 以 此 类 推 。 超 出 范围 的 下 标 
并 不 会 引起 错误 。 比 如 说 ， 当 start 的 位 比 有 序 集 的 最 大 下 二 这 要 大 ， 或 是 
start > stop 时 ，ZRANGE 命令 只 是 简单 地 返回 一 个 空 列表 。 另 一 方面 ， 假 
如 stop 参数 的 值 比 有 序 集 的 最 大 下 标 还 要 大 ， 那 么 Bae stop 当 作 最 大 
下 标 来 处 理 。 可 以 通过 使 用 WITHSCORES 选项 ， 来 让 成 员 和 它 的 score 值 一 并 


返回 ， 返 回 列表 以 _valuel, score1，...，valueN,scoreN 的 格式 表示 。 客 户 端 
库 可 能 会 返回 一 些 更 复 末 的 数据 类 型 ， 比 如 数组 、 元 组 等 。 

可 用 版 本 : 

>= 1.2.0 

时 间 复 条 度 : 


O(log(N)+M), N 为 有 序 集 的 基数 ， 而 M 为 结果 集 的 基数 。 
返回 值 : 
指定 区 间 内 ， 带 有 score 值 ( 可 选 ) 的 有 序 集 成 员 的 列表 。 


redis > ZRANGE 


1) "jack" 

2) "3500" 

3) "tom" 

4) "5000" 

5) "boss" 

6) "10086" 
redis > ZRANGE 
1) "tom" 

2) "5000" 

3) "boss" 

4) "10086" 
redis > ZRANGE 
1) "jack" 

2) "3500" 

3) "tom" 

4) "5000" 

5) "boss" 

6) "10086" 


redis > ZRANGE 
(empty list or 


E 岂 


salary © -1 WITHSCORES 


salary 1 2 WITHSCORES 


salary 0 200000 WITHSCORES 


salary 200000 3000000 WITHSCORES 
set) 


显示 有 序 集 下 标 区 中 


测试 end Fat 


测试 当 给 定 区 间 不 有 





ZRANGEBYSCORE 


ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count] 


返回 有 序 集 key H, MA score 值 介 于 min 和 max 之 间 ( 包 括 等 于 min 
或 max ) 的 成 员 。 有 序 集成 员 按 score 值 递增 (从 小 到 大 ) 次 序 排列 。 


具有 相同 score 值 的 成 员 按 字典 序 (lexicographical order) 来 排列 (该 属性 是 有 序 
集 提供 的 ， 不 需要 额外 的 计算 )。 


可 选 的 LIMIT 参数 指定 返回 结果 的 数量 及 区 间 ( 就 像 SQL 中 的 
SELECT LIMIT offset，count )， 注 意 当 offset 很 大 时 ， 定 位 offset 的 
操作 可 能 需要 通 万 整个 有 序 集 ， 此 过 程 最 坏 复 条 度 为 ON) 时 间 。 


可 选 的 WITHSCORES 参数 决定 结果 集 是 单单 返回 有 序 集 的 成 员 ， 还 是 将 有 序 集成 
ARE score 值 一 起 返回 。 该 选项 自 Redis 2.0 版 本 起 可 用 。 


EX ja) RACER 


min 和 max 可 以 是 -inf 和 +inf ， 这 样 一 来 ， 你 就 可 以 在 不 知道 有 序 集 
的 最 低 和 最 高 score 值 的 情况 下 ， 使 用 ZRANGEBYSCORE 这 类 命令 。 


默认 情况 下 ， 区 间 的 取 值 使 用 闭 区 间 (小 于 等 于 或 大 于 等 于 )， 你 也 可 以 通过 给 参数 
前 增加 ( 符号 来 使 用 可 选 的 开 区 间 (小 于 或 大 于 )。 


举 个 例子 : 


ZRANGEBYSCORE zset (1 5 


返回 所 有 符合 条 件 1 &lt; score &lt;= 5 的 成 员 ， 而 


ZRANGEBYSCORE zset (5 (10 


则 返回 所 有 符合 条 件 5 alt; score &lt; 10 的 成 员 。 

可 用 版 本 : 

>= 1.0.5 

时 间 复 杂 度 : 

O(log(N)+M), n 为 有 序 集 的 基数 ， M 为 被 结果 集 的 基数 。 
返回 值 : 

指定 区 间 内 ， 带 有 score 值 (可 选 ) 的 有 序 集成 员 的 列表 。 


redis> ZADD salary 2500 jack # 测试 数据 
(integer) 0 

redis> ZADD salary 5000 tom 

(integer) 0 

redis> ZADD salary 12000 peter 

(integer) 0 


redis> ZRANGEBYSCORE salary -inf +inf # 显示 整个 有 序 集 
1) "jack" 

2) "tom" 

3) "peter" 

redis> ZRANGEBYSCORE salary -inf +inf WITHSCORES # 显示 整个 有 序 集 7 
1) "jack" 

2) "2500" 

3) "tom" 

4) "5000" 

5) "peter" 

6) "12000" 

redis> ZRANGEBYSCORE salary -inf 5000 WITHSCORES # 显示 工资 <=50C 
1) "jack" 

2) "2500" 

3) "tom" 

4) "5000" 

redis> ZRANGEBYSCORE salary (5000 400000 # 显示 工资 大 于 5( 
1) "peter" 


E 





ZRANK 


ZRANK key member 


返回 有 序 集 key 中 成 员 member 的 排名 。 其 中 有 序 集成 员 按 score 值 递增 
(从 小 到 大 ) 顺 序 排列 。 


排名 以 o 为 底 ， 也 就 是 说 ， score 值 最 小 的 成 员 排名 为 9 。 

使 用 ZREVRANK 命令 可 以 获得 成 员 按 score 值 递 减 (从 大 到 小 ) 排 列 的 排名 。 
可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(log(N)) 

返回 值 : 


如 果 member 是 有 序 集 key 的 成 员 ， 返 回 member 的 排名 。 如 果 member 
不 是 有 序 集 key RK, WE nil 。 


redis> ZRANGE salary 9 -1 WITHSCORES # 显示 所 有 成 员 及 其 score 
1) "peter" 

2) "3500" 

3) "tom" 

4) "4000" 

5) "jack" 

6) "5000" 

redis> ZRANK salary tom # 显示 tom 的 薪水 排名 ， 第 : 


(integer) 1 
E E] 





ZREM 


ZREM key member [member ...] 
移 除 有 序 集 key 中 的 一 个 或 多 个 成 员 ， 不 存在 的 成 员 将 被 忽略 。 
当 key 存在 但 不 是 有 序 集 类 型 时 ， 返 回 一 个 错误 。 


Note 

在 Redis 2.4 版 本 以 前 ， ZREM 每 次 只 能 删除 一 个 元 素 。 
可 用 版 本 : 

>= 1.2.0 

时 间 复 条 度 : 


O(M*log(N))， N 为 有 序 集 的 基数 ， M 为 被 成 功 移 除 的 成 员 的 数量 。 
返回 值 : 
被 成 功 移 除 的 成 员 的 数量 ， 不 包括 被 忽略 的 成 员 。 


# 测试 数据 


redis> ZRANGE page_rank 0 -1 WITHSCORES 
1) "bing.com" 


2) ou 

3) "baidu.com" 
4) WO 

5) "google.com" 
6) "10" 


# 移 除 单个 元 素 


redis> ZREM page_rank google.com 
(integer) 1 


redis> ZRANGE page_rank © -1 WITHSCORES 
1) "bing.com" 


2) O 
3) "baidu.com" 
4) Wro 


# 移 除 多 个 元 素 


redis> ZREM page_rank baidu.com bing.com 
(integer) 2 


redis> ZRANGE page_rank © -1 WITHSCORES 
(empty list or set) 


# 移 除 不 存在 元 素 


redis> ZREM page_rank non-exists-element 
(integer) 0 


ZREMRANGEBYRANK 


ZREMRANGEBYRANK key start stop 
移 除 有 序 集 key 中 ， 指 定 排 名 (rank) 区 间 内 的 所 有 成 员 。 
区 间 分 别 以 下 标 人 参数 start 和 stop HW, AB start 和 stop 在 内 。 


下 标 参数 start 和 stop 都 以 9 AB, hie, A 9 表示 有 序 集 第 一 个 
RA, A 1 表示 有 序 集 第 二 个 成 员 ， 以 此 类 推 。 你 也 可 以 使 用 负数 下 标 ， 以 
-1 表示 最 后 一 个 成 员 ， -2 表示 倒数 第 二 个 成 员 ， 以 此 类 推 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(log(N)+M), N 为 有 序 集 的 基数 ， 而 M 为 被 移 除 成 员 的 数量 。 

返回 值 : 

被 移 除 成 员 的 数量 。 
redis> ZADD salary 2000 jack 
(integer) 1 
redis> ZADD salary 5000 tom 
(integer) 1 
redis> ZADD salary 3500 peter 
(integer) 1 


redis> ZREMRANGEBYRANK salary © 1 # 移 除 下 标 0 至 1 区 间 内 的 成 员 
(integer) 2 


redis> ZRANGE salary © -1 WITHSCORES # 有 序 集 只 剩 下 一 个 成 员 
1) "tom" 
2) "5000" 


二 | 


ZREMRANGEBYSCORE 


ZREMRANGEBYSCORE key min max 


移 除 有 序 集 key H, MA score 值 介 于 min 和 max 之 间 ( 包 括 等 于 min 
或 max ) 的 成 员 。 


自 版 本 2.1.6 开 始 ， score 值 等 于 min 或 max 的 成 员 也 可 以 不 包括 在 内 ， 详 
情 请 参见 ZRANGEBYSCORE AS. 


可 用 版 本 : 
>= 1.2.0 
时 间 复 杂 度 : 
O(log(N)+M), N 为 有 序 集 的 基数 ， 而 M 为 被 移 除 成 员 的 数量 。 
返回 值 : 
被 移 除 成 员 的 数量 。 
redis> ZRANGE salary 0 -1 WITHSCORES # 显示 有 序 集 内 所 有 成 员 及 
2) "2600" 
3) "peter" 
4) "3500" 


5) "jack" 
6) "5000" 


redis> ZREMRANGEBYSCORE salary 1500 3500 # 移 除 所 有 薪水 在 1500 至 
(integer) 2 


redis> ZRANGE salary © -1 WITHSCORES # 剩 下 的 有 序 集 成 员 
1) "jack" 
2) "5000" 


了 — 8 





ZREVRANGE 


ZREVRANGE key start stop [WITHSCORES] 
返回 有 序 集 key 中 ， 指 定 区 间 内 的 成 员 。 


其 中 成 员 的 位 置 按 score 值 递减 (从 大 到 小 ) 来 排列 。 具 有 相同 score 值 的 成 员 
按 字典 序 的 逆序 (reverse lexicographical order) 排 列 。 


除了 成 员 按 score 值 递减 的 次 序 排列 这 一 点 外 ， ZREVRANGE 命令 的 其 他 方面 
和 ZRANGE 命令 一 样 。 


可 用 版 本 : 

>= 1.2.0 

时 间 复 条 度 : 

O(log(N)+M)， N 为 有 序 集 的 基数 ， 而 M 为 结果 集 的 基数 。 
返回 值 : 

指定 区 间 内 ， 带 有 score 值 (可 选 ) 的 有 序 集成 员 的 列表 。 


redis> ZRANGE salary 0 -1 WITHSCORES # 递增 排列 
1) "peter" 

2) "3500" 

3) "tom" 

4) "4000" 

5) "jack" 

6) "5000" 


redis> ZREVRANGE salary © -1 WITHSCORES # 递减 排列 
1) "jack" 

2) "5000" 

3) "tom" 

4) "4000" 

5) "peter" 

6) "3500" 


ZREVRANGEBYSCORE 


ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count] 


返回 有 序 集 key H, score 值 介 于 max 和 min 之 间 ( 默 认 包括 等 于 max 
或 min ) 的 所 有 的 成 员 。 有 序 集成 员 按 score 值 递 减 (从 大 到 小 ) 的 次 序 排 列 。 


具有 相同 score 值 的 成 员 按 字典 序 的 逆序 (reverse lexicographical order ) 排 列 。 


除了 成 员 按 score 值 递减 的 次 序 排列 这 一 点 外 ， ZREVRANGEBYSCORE 命令 
的 其 他 方面 和 ZRANGEBYSCORE 命令 一 样 。 


可 用 版 本 : 
>= 2.2.0 
时 间 复 杂 度 : 
O(log(N)+M), AN 为 有 序 集 的 基数 ， M 为 结果 集 的 基数 。 
返回 值 : 
指定 区 间 内 ， 带 有 score 值 (可 选 ) 的 有 序 集成 员 的 列表 。 
redis > ZADD salary 10086 jack 
(integer) 1 
redis > ZADD salary 5000 tom 
(integer) 1 
redis > ZADD salary 7500 peter 
(integer) 1 
redis > ZADD salary 3500 joe 
(integer) 1 


redis > ZREVRANGEBYSCORE salary +inf -inf # 逆序 排列 所 有 成 员 
1) "jack" 


2) "peter" 
3) "tom" 
4) "joe" 


redis > ZREVRANGEBYSCORE salary 10000 2000 # 逆序 排列 薪水 介 于 10000 
1) "peter" 

2) "tom" 

3) "joe" 


| 





ZREVRANK 


ZREVRANK key member 


返回 有 序 集 key 中 成 员 member 的 排名 。 其 中 有 序 集成 员 按 score 值 递 减 
(从 大 到 小 ) 排 序 。 


排名 以 o 为 底 ， 也 就 是 说 ， score 值 最 大 的 成 员 排 名 为 © 。 

使 用 ZRANK 命令 可 以 获得 成 员 按 score 值 递 增 ( 从 小 到 大 ) 排 列 的 排名 。 
可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(log(N)) 

返回 值 : 


如 果 member 是 有 序 集 key 的 成 员 ， 返 回 member 的 排名 。 如 果 member 
不 是 有 序 集 key RK, WE nil 。 


redis 127.0.0.1:6379> ZRANGE salary 9 -1 WITHSCORES # 测试 数据 
1) "jack" 

2) "2000" 

3) "peter" 

4) "3500" 

5) "tom" 

6) "5000" 

redis> ZREVRANK salary peter # peter 的 工资 排 第 二 


(integer) 1 


redis> ZREVRANK salary tom # tom 的 工资 最 高 
(integer) 0 


nn 


ZSCORE 


ZSCORE key member 

返回 有 序 集 key 中 ， 成 员 member 的 score 值 。 

如 果 member 元 素 不 是 有 序 集 key MRA, 或 key 不 存在 ， 返 回 nil 。 
可 用 版 本 : 

>= 1.2.0 

时 间 复杂 度 : 

O(1) 

返回 值 : 

member 成 员 的 score 值 ， 以 字符 串 形式 表示 。 


redis> ZRANGE salary © -1 WITHSCORES # 测试 数据 


1) "tom" 

2) "2000" 

3) "peter" 

4) "3500" 

5) "jack" 

6) "5000" 

redis> ZSCORE salary peter # 注意 返回 值 是 字符 串 


"3500" 


ZUNIONSTORE 
ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight 
...]] [AGGREGATE SUM|MIN|MAX] 


计算 给 定 的 一 个 或 多 个 有 序 集 的 并 集 ， 其 中 给 定 key 的 数量 必须 以 numkeys 
参数 指定 ， 并 将 该 并 集 (结果 集 ) 储 存 到 destination 。 


默认 情况 下 ， 结 果 集 中 某 个 成 员 的 score 值 是 所 有 给 定 集 下 该 成 员 score 值 
之 和 。 


WEIGHTS 


使 用 WEIGHTS 选项 ， 你 可 以 为 每 个 给 定 有 序 集 分 别 指定 一 个 乘法 因子 
(multiplication factor)， 每 个 给 定 有 序 集 的 所 有 成 员 的 score 值 在 传递 给 聚合 男 
数 (aggregation function) 之 前 都 要 先 乘 以 该 有 序 集 的 因子 。 


如 果 没 有 指定 WEIGHTS 选项 ， 乘 法 因子 默认 设置 为 1 。 
AGGREGATE 
使 用 AGGREGATE 选项 ， 你 可 以 指定 并 集 的 结果 集 的 聚合 方式 。 


默认 使 用 的 参数 sum ， 可 以 将 所 有 集合 中 某 个 成 员 的 score 值 之 和 作为 结果 
集中 该 成 员 的 score 值 ; 使 用 参数 min ， 可 以 将 所 有 集合 中 某 个 成 员 的 最 小 
score 值 作为 结果 集中 该 成 员 的 score 值 ; 而 参数 max 则 是 将 所 有 集合 中 
某 个 成 员 的 最 大 score 值 作为 结果 集中 该 成 员 的 score 值 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(N)+O(M log(M))， N 为 给 定 有 序 集 基数 的 总 和 ， M 为 结果 集 的 基数 。 
退回 值 : 

保存 到 destination 的 结果 集 的 基数 。 


redis> ZRANGE programmer © -1 WITHSCORES 


1) "peter" 
2) "2000" 
3) "jack" 
4) "3500" 
5) "tom" 
6) "5000" 
redis> ZRANGE manager © -1 WITHSCORES 
1) "herry" 
2) "2000" 
3) "mary" 
4) "3500" 
5) "bob" 
6) "4000" 


redis> ZUNIONSTORE salary 2 programmer manager WEIGHTS 1 3 # 公司 
(integer) 6 


redis> ZRANGE salary © -1 WITHSCORES 


1) "peter" 
2) "2000" 
3) "jack" 
4) "3500" 
5) "tom" 
6) "5000" 
7) "herry" 
8) "6000" 
9) "mary" 
10) "10500" 
11) "bob" 
12) "12000" 


Er 下 





ZINTERSTORE 
ZINTERSTORE destination numkeys key [key ...] [WEIGHTS weight [weight 
...]] [AGGREGATE SUM|MIN|MAX] 


计算 给 定 的 一 个 或 多 个 有 序 集 的 交集 ， 其 中 给 定 key 的 数量 必须 以 numkeys 
参数 指定 ， 并 将 该 交集 (结果 集 ) 储 存 到 destination 。 


默认 情况 下 ， 结 果 集 中 某 个 成 员 的 score 值 是 所 有 给 定 集 下 该 成 员 score 值 
之 和 . 


关于 WEIGHTS 和 AGGREGATE 选项 的 描述 ， 参 见 ZUNIONSTORE 命令 。 
可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 


O(NK)+O(Mlog(M)), N 为 给 定 key 中 基数 最 小 的 有 序 集 ， Kk 为 给 定 有 序 集 
的 数量 ， M 为 结果 集 的 基数 。 


退回 值 : 
保存 到 destination 的 结果 集 的 基数 。 


redis > ZADD 
(integer) 1 
redis > ZADD 
(integer) 1 
redis > ZADD 
(integer) 1 


redis > ZADD 
(integer) 1 
redis > ZADD 
(integer) 1 
redis > ZADD 
(integer) 1 


mid_test 
mid_test 


mid_test 


fin_test 
fin_test 


fin_test 


70 


70 


99F 


88 


75 


99. 


Hai enS 


"Han Meimei" 


5 "Tom" 


Aa eae 


"Han Meimei" 


5 "Tom" 


redis > ZINTERSTORE sum_point 2 mid_test 


(integer) 3 


redis > ZRANGE sum_point © -1 WITHSCORES 
1) "Han Meimei" 


2) "145" 
3) ey 
4) "158" 
5) "Tom" 


6) "4799"! 





fin test 


# 显示 有 序 集 内 所 有 成 员 及 


E 


一 


ZSCAN 


ZSCAN key cursor [MATCH pattern] [COUNT count] 


详细 信息 请 参考 SCAN 命令 。 


Pub/Sub 发布 /订阅 ) 


PSUBSCRIBE 


PSUBSCRIBE pattern [pattern ...] 
订阅 一 个 或 多 个 符合 给 定 模式 的 频道 。 


每 个 模式 以 * 作为 匹配 符 ， 比 如 it* 匹配 所 有 以 it 开头 的 频道 ( 
it.news 、 it.blog 、 it.tweets 等 等 )， news.* 匹配 所 有 以 news. 
开头 的 频道 ( news.it 、 news.global.today 等 等 )， 诸 如 此 类 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(N), N 是 订阅 的 模式 的 数量 。 
返回 值 : 

接收 到 的 信息 (请 参见 下 面 的 代码 说 明 )。 


# 订阅 news.* 和 tweet.* 两 个 模式 


# 第 1 - 6 行 是 执行 psubscribe 之 后 的 反馈 信息 
# 第 7 - 10 才 是 接收 到 的 第 一 条 信息 
# 第 11 - 14 是 第 二 条 

# 以 此 类 推 。。。 


redis> psubscribe news.* tweet.* 


Reading messages... (press Ctrl-C to quit) 

1) "psubscribe" # 返回 值 的 类 型 : 显示 订阅 成 功 
2) "news.*" # 订阅 的 模式 

3) (integer) 1 # 目前 已 订阅 的 模式 的 数量 


1) "psubscribe" 
2) "tweet.*" 
3) (integer) 2 


1) "pmessage" # 返回 值 的 类 型 : 信息 
2) "news. *" # 信息 匹配 的 模式 

3) "news.it" # 信息 本 身 的 目标 频道 
4) "Google buy Motorola" # 信息 的 内 容 


1) "pmessage" 


2) "tweet.*" 
3) "tweet.huangz" 
4) "hello" 


1) "pmessage" 

2) "tweet.*" 

3) "tweet.joe" 

4) "@huangz morning" 


1) "pmessage" 

2) "news. *" 

3) "news.life" 

4) "An apple a day, keep doctors away" 


PUBLISH 


PUBLISH channel message 

将 信息 message 发 送 到 指定 的 频道 channel 。 
可 用 版 本 : 

>= 2.0.0 

时 间 复 条 度 : 


O(N+M)， 其 中 N 是 频道 channel 的 订阅 者 数量 ， 而 M 则 是 使 用 模式 订阅 
(subscribed patterns) 的 客户 端的 数量 。 


返回 值 : 
接收 到 信息 message 的 订阅 者 数量 。 


# 对 没有 订阅 者 的 频道 发 送信 息 


redis> publish bad_channel "can any body hear me?" 
(integer) 0 


# 向 有 一 个 订阅 者 的 频道 发 送信 息 


redis> publish msg "good morning" 
(integer) 1 


# 向 有 多 个 订阅 者 的 频道 发 送信 息 


redis> publish chat_room "hello~ everyone" 
(integer) 3 


PUBSUB 


PUBSUB <subcommand> [argument [argument ...]] 


PUBSUB 是 一 个 查看 订阅 与 发 布 系统 状态 的 内 省 命令 ， 它 由 数 个 不 同 格式 的 子 命 
仿 组 成 ， 以 下 将 分 别 对 这 些 子 命令 进行 介绍 。 


可 用 版 本 : >= 2.8.0 


PUBSUB CHANNELS [pattern] 


列 出 当前 的 活跃 频道 。 
活跃 频道 指 的 是 那些 至 少 有 一 个 订阅 者 的 频道 ， 订阅 模式 的 客户 端 不 计算 在 内 。 
pattern 参数 是 可 选 的 : 


e 如 果 不 给 出 pattern 参数 ， 那 么 列 出 订阅 与 发 布 系统 中 的 所 有 活路 频道 。 
e 如 果 给 出 pattern 参数， 那么 只 列 出 和 给 定 模式 pattern 相 匹 配 的 那些 
活跃 频道 。 
FE: O(N), N 为 活跃 频道 的 数量 (对 于 长 度 较 短 的 频道 和 模式 来 说 ， 将 进 
行 模式 匹配 的 复杂 度 视 为 常数 ) 。 


返回 值 : 一 个 由 活跃 频道 组 成 的 列表 。 


# Client-1 订阅 news.it 和 news.sport 两 个 频道 


client-1> SUBSCRIBE news.it news.sport 
Reading messages... (press Ctrl-C to quit) 
1) "subscribe" 

2) “news.it" 

3) (integer) 1 

1) "subscribe" 

2) "news.sport" 

3) (integer) 2 


# client-2 订阅 news.it 和 news.internet 两 个 频道 


client-2> SUBSCRIBE news ,it news.internet 
Reading messages... (press Ctrl-C to quit) 
1) "subscribe" 

2) "news.it" 

3) (integer) 1 

1) "subscribe" 

2) "news.internet" 

3) (integer) 2 


# 5, client-3 打印 所 有 活跃 频道 
# 注意 ， 即 使 一 个 频道 有 多 个 订阅 者 ， 它 也 只 输出 一 次 ， 上 比如 news .it 


client-3> PUBSUB CHANNELS 
1) "news.sport" 

2) "news.internet" 

3) "news.it" 


# 接 下 来 ， client-3 打印 那些 与 模式 news.i* 相 匹 配 的 活跃 频道 
# 因为 news. sport 不 匹配 news.i* ， 所 以 它 没 有 被 打印 


redis> PUBSUB CHANNELS news.i* 
1) "news.internet” 
2) "news.it" 


PUBSUB NUMSUB [channel-1 ... channel-N] 


返回 给 定 频 道 的 订阅 者 数量 ， 订阅 模式 的 客户 端 不 计算 在 内 
复杂 度 : O(N), N 为 给 定 频道 的 数量 。 


返回 值 : 一 个 多 条 批量 回复 (Multi-bulk reply) ， 回 复 中 包含 给 定 的 频道 ， 以 及 频 
道 的 订阅 者 数量 。 格式 为 : 频道 channel-1 ， channel-1 的 订阅 者 数量 ， 频 
道 channel-2 ， channel-2 的 订阅 者 数量 ， 诸 如 此 类 。 回复 中 频道 的 排列 顺 
序 和 执行 命 舍 时 给 和 致 。 P 定 任何 频道 而 直接 调用 这 个 命 兮 
是 可 以 的 ， 在 这 种 情 ; 命令 只 返回 一 空 列 表 。 


# client-1 订阅 news.it 和 news.sport 两 个 频道 


client-1> SUBSCRIBE news.it news.sport 
Reading messages... (press Ctrl-C to quit) 
1) "subscribe" 

2) "news.it" 

3) (integer) 1 

1) "subscribe" 

2) "news.sport" 

3) (integer) 2 


# client-2 订阅 news.it 和 news.internet 两 个 频道 


client-2> SUBSCRIBE news.it news.internet 
Reading messages... (press Ctrl-C to quit) 
1) "subscribe" 

2) “news.it" 

3) (integer) 1 

1) "subscribe" 

2) "news.internet" 

3) (integer) 2 


# Client-3 打印 各 个 频道 的 订阅 者 数量 


client-3> PUBSUB NUMSUB news.it news.internet news.sport news.music 
1) "news.it" # 频道 


2) 2 # 订阅 该 频道 的 客户 端 数量 
3) "news.internet" 

4) Ue Fl 

5) "news.sport" 

6) UU A 

7) "news .music" # 没有 任何 订阅 者 

8) "o" 





PUBSUB NUMPAT 


返回 订阅 模式 的 数量 。 


注意 ， 这 个 命令 返回 的 不 是 订阅 模式 的 客户 端的 数量 ， 而 是 客户 端 订 阅 的 所 有 模 
式 的 数量 总 和 。 


BRE: O(1) 。 
返回 值 : 一 个 整数 回复 (Integer reply) 。 


# client-1 订阅 news.* 和 discount.* 两 个 模式 


client-1> PSUBSCRIBE news.* discount. * 
Reading messages... (press Ctrl-C to quit) 
1) "psubscribe" 

2) “news.*" 

3) (integer) 1 

1) "psubscribe" 

2) "discount. *" 

3) (integer) 2 


# client-2 订阅 tweet.* 一 个 模式 


client-2> PSUBSCRIBE tweet.* 


Reading messages... (press Ctrl-C to quit) 
1) "psubscribe" 
2) "tweet.*" 


3) (integer) 1 
# client-3 返回 当前 订阅 模式 的 数量 为 3 


client-3> PUBSUB NUMPAT 
(integer) 3 


# 注意 ， 当 有 多 个 客户 端 订阅 相同 的 模式 时 ， 相 同 的 订阅 也 被 计算 在 PUBSUB NUMPAT xz 
# 比如 说 ， 再 新 建 一 个 客户 端 client-4 ， 让 它 也 订阅 news.* 频道 


client-4> PSUBSCRIBE news. * 

Reading messages... (press Ctrl-C to quit) 
1) "psubscribe" 

2) "news.*" 

3) (integer) 1 


# 这 时 再 计算 被 订阅 模式 的 数量 ， 就 会 得 到 数量 为 4 


client-3> PUBSUB NUMPAT 
(integer) 4 


O—————————— re 





PUNSUBSCRIBE 


PUNSUBSCRIBE [pattern [pattern ...]] 

指示 客户 端 退 订 所 有 给 定 模 式 。 

如 果 没 有 模式 被 指定 ， 也 即 是 ， 一 个 无 参数 的 PUNSUBSCRIBE 调用 被 执行 ， 那 么 
客户 端 使 用 PSUBSCRIBE 命令 订阅 的 所 有 模式 都 会 被 退 订 。 在 这 种 情况 下 ， 命 兮 
会 返回 一 个 信息 ， 告 知客 户 端 所 有 被 退 订 的 模式 。 

可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 


O(N+M) ， 其 中 N 是 客户 端 已 订阅 的 模式 的 数量 ， M 则 是 系统 中 所 有 客户 端 订 
阅 的 模式 的 数量 。 


返回 值 : 
这 个 命令 在 不 同 的 客户 端 中 有 不 同 的 表现 。 


SUBSCRIBE 


SUBSCRIBE channel [channel ...] 
订阅 给 定 的 一 个 或 多 个 频道 的 信息 。 
可 用 版 本 : 
>= 2.0.0 

at a) SAE: 
O(N)， 其 中 N 是 订阅 的 频道 的 数量 。 
返回 值 : 
接收 到 的 信息 (请 参见 下 面 的 代码 说 明 )。 


# 订阅 msg 和 chat_room 两 个 频道 


- 6 行 是 执行 subscribe 之 后 的 反馈 信息 
7 - 9 行 示 是 接收 到 的 第 一 条 信息 
10 - 12 行 是 第 二 条 


redis> subscribe msg chat_room 


Reading messages... 


"subscribe" 
"msg" 
(integer) 1 


"subscribe" 
"chat_room" 
(integer) 2 


"message" 
"msg" 
"hello moto" 


"message" 
"chat_room" 


"testing. .-haha" 


(press Ctrl-C to quit) 

# 返回 值 的 类 型 : 显示 订阅 成 功 
# 订阅 的 频道 名 字 

# 目前 已 订阅 的 频道 数量 


# 返回 值 的 类 型 : 信息 
# 来 源 ( 从 那个 频道 发 送 过 来 ) 
# 信息 内 容 


UNSUBSCRIBE 


UNSUBSCRIBE [channel [channel ...]] 
指示 客户 端 退 订 给 定 的 频道 。 


如 果 没 有 频道 被 指定 ， 也 即 是 ， 一 个 无 参数 的 UNSUBSCRIBE 调用 被 执行 ， 那 么 
客户 端 使 用 SUBSCRIBE 命令 订阅 的 所 有 频道 都 会 被 退 订 。 在 这 种 情况 下 ， 命 令 会 
返回 一 个 信息 ， 告 知客 户 端 所 有 被 退 订 的 频道 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 

O(N), N 是 客户 端 已 订阅 的 频道 的 数量 。 
返回 值 


这 个 命令 在 不 同 的 客户 端 中 有 不 同 的 表现 。 


Transaction (事务 ) 


DISCARD 


DISCARD 
取消 事务 ， 放 奔 执行 事务 块 内 的 所 有 命令。 


如 果 正 在 使 用 WATCH 命令 监视 某 个 (或 某 些 ) key， 那 么 取消 所 有 
行 命令 UNWATCH 。 


可 用 版 本 : 
>= 2.0.0 


redis> MULTI 
OK 


redis> PING 
QUEUED 


redis> SET greeting "hello" 
QUEUED 


redis> DISCARD 
OK 


Wk 
全 


视 ， 等 同 于 执 


EXEC 


EXEC 
执行 所 有 事务 块 内 的 命令 。 


假如 某 个 (或 某 些 ) key 正 处 于 WATCH 命令 的 监视 之 下 ， 且 事务 块 中 有 和 这 个 (或 这 
些 ) key KM GE, ABA EXEC 命令 只 在 这 个 (或 这 些 ) key 没有 被 其 他 命令 所 改 
动 的 情况 下 执行 并 生效 ， 否 则 该 事务 被 打 断 (abort)。 


可 用 版 本 : 

>= 1.2.0 

时 间 复 条 度 : 

事务 块 内 所 有 命令 的 时 间 复 条 度 的 总 和 。 

返回 值 : 

es 
# 事务 被 成 功 执 行 


redis> MULTI 
OK 


redis> INCR user_id 
QUEUED 


redis> INCR user_id 
QUEUED 


redis> INCR user_id 
QUEUED 


redis> PING 
QUEUED 


redis> EXEC 

1) (integer) 1 
2) (integer) 2 
3) (integer) 3 
4) PONG 


# 监视 key ， 且 事务 成 功 执行 


redis> WATCH lock lock times 
OK 


redis> MULTI 
OK 


redis> SET lock "huangz" 
QUEUED 


redis> INCR lock times 
QUEUED 


redis> EXEC 

1) OK 

2) (integer) 1 

# 监视 key ， 且 事务 被 打 断 


redis> WATCH lock lock times 
OK 


redis> MULTI 
OK 


redis> SET lock "joe" # 就 在 这 时 ， 另 一 个 客户 端 修改 了 lock_times 
QUEUED 


redis> INCR lock times 
QUEUED 


redis> EXEC # 因为 lock_times WEA, joe 的 事务 执行 
(nil) 


a ——— 





MULTI 


MULTI 
标记 一 个 事务 块 的 开始 。 


事务 块 内 的 多 条 命令 会 按照 先后 顺序 被 放 进 一 个 队列 当中 ， 最 后 由 EXEC 命令 原 子 
性 (atomic) 地 执行 。 


可 用 版 本 : 
>= 1.2.0 


redis> MULTI # 标记 事务 开始 
redis> INCR user_id # 多 条 命令 按 顺序 人 队 


redis> INCR user_id 
QUEUED 


redis> INCR user_id 
QUEUED 


redis> PING 
QUEUED 


redis> EXEC # 执行 
1) (integer) 1 

2) (integer) 2 

3) (integer) 3 

4) PONG 


UNWATCH 


UNWATCH 
取消 WATCH 643 xt AT key 的 监视 。 


如 果 在 执行 WATCH 命令 之 后 ，_ EXEC a DISCARD 命令 先 被 执行 了 的 话 ， 
那么 就 不 需要 再 执行 UNWATCH 了 。 


因为 EXEC 命令 会 执行 事务 ， 因 此 WATCH 命令 的 效果 已 经 产生 了 ; 而 DISCARD 
命令 在 取消 事务 的 同时 也 会 取消 所 有 对 key 的 监视 ， 因 此 这 两 个 命令 执行 之 后 ， 就 
没有 必要 执行 UNWATCH 了 。 


可 用 版 本 : 
>= 2.2.0 
时 间 复 杂 度 : 
O(1) 
返回 值 : 
总 是 OK 。 
ne WATCH lock lock_times 


redis> UNWATCH 
OK 


WATCH 


WATCH key [key ...] 


监视 一 个 (或 多 个 ) key ， 如 果 在 事务 执行 之 前 这 个 (或 这 些 ) key 被 其 他 命令 所 改 
动 ， 那 么 事务 将 被 打 断 。 


可 用 版 本 : 

>= 2.2.0 

时 间 复 条 度 : 
O(1)。 

返回 值 : 
XERE] OK 。 


redis> WATCH lock lock times 
OK 


Script (HÆ) 


EVAL 


EVAL script numkeys key [key ...] arg [arg ...] 


从 Redis 2.6.0 版 本 开始 ， 通 过 内 置 的 Lua 解释 器 ， 可 以 使 用 EVAL 命令 对 Lua 脚 
本 进行 求 值 。 


script 参数 是 一 段 Lua 5.1 脚本 程序 ， 它 会 被 运行 在 Redis 服务 器 上 下 文中 ， 
这 段 脚本 不 必 ( 也 不 应 该 ) 定 义 为 一 个 Lua EBM. 


numkeys 参数 用 于 指定 键 名 参数 的 个 数 。 


键 名 参数 key [key ...] M EVAL 的 第 三 个 参数 开始 算 起 ， 表 示 在 脚本 中 所 用 
到 的 那些 Redis 键 (key)， 这 些 键 名 参数 可 以 在 Lua 中 通过 全 局 变量 KEYS 数组 ， 
用 1 为 基 址 的 形式 访问 ( KEYS[1] ， KEYS[2] ， 以 此 类 推 )。 


在 命令 的 最 后 ， 那 些 不 是 键 名 参数 的 附加 参数 arg [arg ...] ， 可 以 在 Lua 中 
通过 全 局 变量 ARGV 数组 访问 ， 访 问 的 形式 和 KEYS 变量 类 似 ( ARGV[1] 、 
ARGV[2] ， 诸 如 此 类 )。 


上 面 这 几 段 长 长 的 说 明 可 以 用 一 个 简单 的 例子 来 概括 : 


> eval "return {KEYS[1],KEYS[2],ARGV[1],ARGV[2]}" 2 key1 key2 first 


1) "key1" 
2) "key2" 
a) Te 


4) "second" 





其 中 "return {KEYS[1],KEYS[2],ARGV[1],ARGV[2]}" 是 被 求 值 的 Lua 脚本 ， 
数字 2 指定 了 键 名 参数 的 数量 ， key1 和 key2 是 键 名 参数 ， 分 别 使 用 
KEYS[1] 和 KEYS[2] 访问 ， 而 最 后 的 first 和 second 则 是 附加 参数 ， 
可 以 通过 ARGV[1] 和 ARGV[2] 访问 它们 。 


在 Lua 脚本 中 ， 可 以 使 用 两 个 不 同 函 数 来 执行 Redis PT, CHD Az : 


e redis.call() 
e redis.pcall() 


这 两 个 图 数 的 唯一 区 别 在 于 它们 使 用 不 同 的 方式 处 理 执行 命 合 所 产生 的 错误 ， 在 后 
面 的 『 错 误 处 理 1」 部 分 会 讲 到 这 一 点 。 


redis.call() 和 redis.pcall() 两 个 函数 的 参数 可 以 是 任何 格式 良好 (well 
formed) 的 Redis 命令 : 


> eval "return redis.call('set', 'foo', 'bar')" 0 
OK 


需要 注意 的 是 ， 上 面 这 段 脚本 的 确实 现 了 将 键 foo 的 值 设 为 bar 的 目的 ， 但 
是 ， 它 违反 了 EVAL 命令 的 语义 ， 因 为 脚本 里 使 用 的 所 有 键 都 应 该 由 KEYS 数组 
Rte, ARIE AE : 


> eval "return redis.call('set',KEYS[1], 'bar')" 1 foo 
OK 


要 求 使 用 正确 的 形式 来 传递 键 (key) 是 有 原因 的 ， 因 为 不 仅仅 是 EVAL 这 个 命令 ， 所 
有 的 Redis 命令 ， 在 执行 之 前 都 会 被 分 析 ， 籍 此 来 确定 命令 会 对 哪些 键 进 行 操 作 。 


Auth, st EVAL 命令 来 说 ， 必 须 使 用 正确 的 形式 来 传递 键 ， 才 能 确保 分 析 工作 正 
确 地 执行 。 除 此 之 外 ， 使 用 正确 的 形式 来 传递 键 还 有 很 多 其 他 好 处 ， 它 的 一 个 特别 
重要 的 用 途 就 是 确保 Redis 集群 可 以 将 你 的 请 求 发 送 到 正确 的 集群 节点 。( 对 Redis 
集群 的 工作 还 在 进行 当中 ， 但 是 脚本 功能 被 设计 成 可 以 与 集群 功能 保持 兼容 。) 不 
过 ， 这 条 规矩 并 不 是 强制 性 的 ， 从 而 使 得 用 户 有 机 会 滥用 (abuse) Redis 单 实例 配 
(single instance configuration)， 代 价 是 这 样 写 出 的 脚本 不 能 被 Redis 集群 所 兼 
合 。 


在 Lua 数据 类 型 和 Redis 数据 类 型 之 间 转 换 


当 Lua 通过 call() 或 pcall() 画 数 执行 Redis 命令 的 时 候 ， 命 令 的 返回 值 
会 被 转换 成 Lua 数据 结构 。 同 样 地 ， 当 Lua 脚本 在 Redis 内 置 的 解释 器 里 运行 

at, Lua 脚本 的 返回 值 也 会 被 转换 成 Redis 协议 (protocol)， 然 后 由 EVAL 将 值 返 回 
数据 类 型 之 间 的 转换 遵循 这 样 一 个 设计 原则 : 如 果 将 一 个 Redis 值 转换 成 Lua t, 


之 后 再 籽 转 换 所 得 的 Lua 值 转换 回 Redis 值 ， 那 么 这 个 转换 所 得 的 Redis 值 应 该 
和 最 初时 的 Redis 值 一 样 。 


换 句 话说 ， Lua 类 型 和 Redis 类 型 之 间 存 在 着 一 一 对 应 的 转换 关系 。 
以 下 列 出 的 是 详细 的 转换 规则 : 
从 Redis 转换 到 Lua : 


Redis integer reply -> Lua number / Redis 整数 转换 成 Lua 数字 

Redis bulk reply -> Lua string / Redis bulk 回复 转换 成 Lua 字符 串 

Redis multi bulk reply -> Lua table (may have other Redis data types nested) 
/Redis 多 条 bulk 回复 转换 成 Lua 表 ， 表 内 可 能 有 其 他 别 的 Redis 数据 类 型 
Redis status reply -> Lua table with a single ok field containing the status / 
Redis 状态 回复 转换 成 Lua 表 ， 表 内 的 ok 域 包含 了 状态 信息 

Redis error reply -> Lua table with a single err field containing the error / 
Redis 错误 回复 转换 成 Lua 表 ， 表 内 的 err 域 包含 了 错误 信息 


e Redis Nil bulk reply and Nil multi bulk reply -> Lua false boolean type / Redis 


的 NI 回复 和 Nil 多 条 回复 转换 成 Lua 的 布尔 值 false 
从 Lua 转换 到 Redis : 


e Lua number -> Redis integer reply / Lua 数字 转换 成 Redis 整数 
e Lua string -> Redis bulk reply / Lua 字符 串 转换 成 Redis bulk 回复 


e Lua table (array) -> Redis multi bulk reply / Lua 表 ( 数 组 ) 转 换 成 Redis 多 条 


bulk 回复 


e Lua table with a single ok field -> Redis status reply / 一 个 带 单个 ok 域 的 


Lua 表 ， 转 换 成 Redis 状态 回复 


e Lua table with a single err field -> Redis error reply / 一 个 带 单个 err 域 的 


Lua 表 ， 转 换 成 Redis 错误 回复 
e Lua boolean false -> Redis Nil bulk reply / Lua 的 布尔 值 false 转换 成 
Redis 的 Nil bulk 回复 


从 Lua 转换 到 Redis 有 一 条 额外 的 规则 ， 这 条 规则 没有 和 它 对 应 的 从 Redis 转换 


到 Lua 的 规则 : 


e Lua boolean true -> Redis integer reply with value of 1/ Lua 布尔 值 true 
转换 成 Redis 整数 回复 中 的 1 


以 下 是 几 个 类 型 转换 的 例子 : 


> eval "return 10" 0 
(integer) 10 


> eval "return {1,2,{3,'Hello World! '}}" 0 
1) (integer) 1 
2) (integer) 2 
3) 1) (integer) 3 
2) "Hello World!" 


> eval "return redis.call('get', 'foo')" © 
"bar" 


在 上 面 的 三 个 代码 示例 里 ， 前 两 个 演示 了 如 何 将 Lua 值 转换 成 Redis 值 ， 最 后 一 


个 


例子 更 复杂 一 些 ， 它 演示 了 一 个 将 Redis 值 转换 成 Lua 值 ， 然 后 再 将 Lua 值 转换 


成 Redis 值 的 类 型 转 过 程 。 


脚本 的 原子 性 


Redis 使 用 单个 Lua 解释 器 去 运行 所 有 脚本 ， 并 且 ， Redis 也 保证 脚本 会 以 原子 性 
(atomic) 的 方式 执行 : 当 某 个 脚本 正在 运行 的 时 候 ， 不 会 有 其 他 脚本 或 Redis PA 
被 执行 。 这 和 使 用 MULTI/ EXEC 包围 的 事务 很 类 似 。 在 其 他 别 的 客户 端 看 来 ， 脚 


本 的 效果 (effect) 要 么 是 不 可 见 的 (not visible)， 要 么 就 是 已 完成 的 (already 
completed)。 


另 一 方面 ， 这 也 意味 着 ， 执 行 一 个 运行 缓慢 的 脚本 并 不 是 一 个 好 主意 。 写 一 个 跑 得 
很 快 很 顺 溜 的 脚本 并 不 难 ， 因 为 脚本 的 运行 开销 (overhead) 非 常 少 ， 但 是 当 你 不 得 
不 使 用 一 些 跑 得 比较 慢 的 脚本 时 ， 请 小 心 ， 因 为 当 这 些 蜗牛 脚本 在 慢 吞 知 地 运行 的 
时 人 息 ， 其 他 客户 端 会 因为 服务 器 正 忙 而 无 法 执行 命令 。 


错误 处 理 
前 面 的 命令 介绍 部 分 说 过 ， redis.call() 和 redis.pcall() 的 唯一 区 别 在 
于 它们 对 错误 处 理 的 不 同 。 
当 redis.call() 在 执行 命令 的 过 程 中 发 生 错误 时 ， 脚 本 会 停止 执行 ， 并 返回 一 
个 脚本 错误 ， 错 误 的 输出 信息 会 说 明 错 误 造 成 的 原因 : 

redis> lpush foo a 

(integer) 1 


redis> eval "return redis.call('get', 'foo')" 0 
(error) ERR Error running script (call to f_282297a0228f48cd3fc6a5! 


-| -=~ 


和 redis.call() 不 同 ， redis.pcall() 出 错时 并 不 引发 (raise) 错 误 ， 而 是 
返回 一 个 带 err 域 的 Lua 表 (table)， 用 于 表示 错误 : 





redis 127.0.0.1:6379> EVAL "return redis.pcall('get', 'foo')" © 
(error) ERR Operation against a key holding the wrong kind of value 


二 -= 





带宽 和 EVALSHA 


EVAL 命令 要 求 你 在 每 次 执行 脚本 的 时 候 都 发 送 一 次 脚本 主体 (script body)。Redis 
有 一 个 内 部 的 缓存 机 制 ， 因 此 它 不 会 每 次 都 重新 编译 脚本 ， 不 过 在 很 多 场合 ， 付 出 
无 谓 的 带宽 来 传送 脚本 主体 并 不 是 最 佳 选择 。 

为 了 减少 带宽 的 消耗 ， Redis 实现 了 EVALSHA 命令 ， 它 的 作用 和 EVAL 一 样 ， 都 
用 于 对 脚本 求 值 ， 但 它 接 受 的 第 一 个 参数 不 是 脚本 ， 而 是 脚本 的 SHA1 校 验 和 
(Sum)。 


EVALSHA 命令 的 表现 如 下 : 
e 如 果 服 务 器 还 记得 给 定 的 SHA1 校 验 和 所 指定 的 脚本 ， 那 么 执行 这 个 脚本 
e。 如 果 服 务 器 不 记得 给 定 的 SHA1 校 验 和 所 指定 的 脚本 ， 那 么 它 返 回 一 个 特殊 的 
错误 ， 提 醒 用 户 使 用 EVAL 代替 EVALSHA 


以 下 是 示例 : 


> set foo bar 
OK 


> eval "return redis.call('get', 'foo')" © 
"bar" 


> evalsha 6b1ibf486c81ceb7edf3c093f4c48582e38c0e791 0 
"bar" 


> evalsha ffffffffffffffffffffffffffffffffffffffff O 
(error) ‘NOSCRIPT No matching script. Please use [EVAL](/commands, 


‘| eee | 


客户 端 库 的 底层 实现 可 以 一 直 乐 观 地 使 用 EVALSHA 来 代替 EVAL ， 并 期 望 着 要 使 
用 的 脚本 已 经 保存 在 服务 器 上 了 ， 只 有 当 NOSCRIPT iia 才 使 用 EVAL 
命令 重新 发 送 脚本 ， 这 样 就 可 以 最 大 限度 地 节省 带 


这 也 说 明了 执行 EVAL 命令 时 ， 使 用 正确 的 格式 来 传递 键 名 参数 和 附加 参数 的 重要 
性 : 因为 如 果 将 参数 硬 写 在 脚本 中 ， 那 么 每 次 当 参 数 改 变 的 时 候 ， 都 要 重新 发 送 脚 
本 ， 即 使 脚本 的 主体 并 没有 改变 ， 相 反 ， 通 过 使 用 正确 的 格式 来 传递 键 名 参数 和 附 
加 参数 ， ee 直接 使 用 EVALSHA 命令 对 脚本 进行 复 
用 ， 免 去 了 无 谓 的 带宽 消耗 。 


脚本 缓存 


Redis 保证 所 有 被 运行 过 的 脚本 都 会 被 永久 保存 在 脚本 缓存 当中 ， 这 意味 着 ， 当 
EVAL 命令 在 一 个 Redis 实例 上 成 功 执行 某 个 脚本 之 后 ， 随 后 针对 这 个 脚本 的 所 有 
EVALSHA 命令 都 会 成 功 执行 。 


刷新 脚本 缓存 的 唯一 办 法 是 显 式 地 调用 SCRIPT FLUSH 命令， 这 个 命令 会 清空 运 
行 过 的 所 有 脚本 的 缓存 。 通 常 只 有 在 云 计 算 环境 中 ，Redis 实例 被 改作 其 他 客户 或 
者 别 的 应 用 程序 的 实例 时 ， 才 会 执行 这 个 命令 。 


缓存 可 以 长 时 间 储 存 而 不 产生 内 存 问 题 的 原因 是 ， 它 们 的 体积 非常 小 ， 而 且 数量 也 
非常 少 ， 即 使 脚本 在 概念 上 类 似 于 实现 一 个 新 命 售 ， 即 使 在 一 个 大 规模 的 程序 里 有 
成 百 上 干 的 脚本 ， 即 使 这 些 脚本 会 经 常 修 改 ， 即 便 如 此 ， 储 存 这 些 脚本 的 内 存 仍 然 
是 微不足道 的 。 


用 户 会 发 现 Redis 不 移 除 缓存 中 的 脚本 实际 上 是 一 个 好 主意 。 上 比如 说 ， 对 

一 个 和 Redis 保持 持久 化 链接 (persistent connection) 的 程序 来 说 ， 它 可 以 确信 ， 
te 次 的 脚本 会 一 直 保 留 在 内 存 当 中 ， 因 此 它 可 以 在 流水 线 中 使 用 EVALSHA 
命令 而 不 必 担 心 因 为 找 不 到 所 需 的 脚本 而 产生 错误 ( 稍 候 我 们 会 看 到 在 流水 线 中 执行 
脚本 的 相关 问题 )。 








SCRIPT 命令 


Redis 提供 了 以 下 几 个 SCRIPT 命令 ， 用 于 对 脚本 子 系统 (Scripting subsystem) 
行 控制 : 


SCRIPT FLUSH : 清除 所 有 脚本 缓存 

e SCRIPT EXISTS : 根据 给 定 的 脚本 校 验 和 ， 检 查 指定 的 脚本 是 否 存在 于 脚本 
缓存 

SCRIPT LOAD : 将 一 个 脚本 装 人 脚本 缓存 ， 但 并 不 立即 运行 它 

e SCRIPT KILL : 杀 死 当前 正在 运行 的 脚本 


2, BK BM al AN 


在 编写 脚本 方面 ， 一 个 重要 的 要 求 就 是 ， 脚 本 应 该 被 写成 纯 范 数 (pure function), 
也 就 是 说 ， 脚 本 应 该 具有 以 下 属性 : 


。 对 于 同样 的 数据 集 输入 ， 给 定 相同 的 参数 ， 肢 本 执行 的 Redis 写 命令 总 是 相同 
的 。 脚 本 执行 的 操作 不 能 依赖 于 任何 隐藏 ( 非 星 式 ) 数 据 ， 不 能 依 束 于 脚本 在 执 
行 过 程 中 、 或 脚本 在 不 同 执行 时 期 之 间 可 能 变更 的 状态 ， 并 且 它 也 不 能 依赖 于 
任何 来 自 O 设备 的 外 部 输入 。 


使 用 系统 时 间 (system time)， 调 用 像 RANDOMKEY 那样 的 随机 命令 ， 或 者 使 用 
Lua 的 随机 数 生 成 器 ， 类 似 以 上 的 这 些 操作 ， 都 会 造成 脚本 的 求 值 无 法 每 次 都 得 出 
同样 的 结果 。 


为 了 确保 脚本 符合 上 面 所 说 的 属性 ， Redis 做 了 以 下 工作 : 


e Lua 没有 访问 系统 时 间或 者 其 他 内 部 状态 的 命令 

e Redis 会 返回 一 个 错误 ， 阻 止 这 样 的 脚本 运行 : 这 些 脚本 在 执行 随机 命令 之 后 
(比如 RANDOMKEY 、 SRANDMEMBER 或 TIME 等 )， 还 会 执行 可 以 修改 数 
据 集 的 Redis 命 爷 。 如 果 脚 本 只 是 执行 只 读 操 作 ， 那 么 就 没有 这 一 限制 。 注 
意 ， 随 机 命令 并 不 一 定 就 指 那些 带 RAND 字眼 的 命令 ， 任 何 带 有 非 确定 性 的 命 
兮 都 会 被 认为 是 随机 命令 ， 比 如 TIME 命令 就 是 这 方面 的 一 个 很 好 的 例子 。 
每 当 从 Lua 脚本 中 调用 那些 返回 无 序 元 素 的 命 信 时， 执行 命令 所 得 的 数据 在 返 
回 给 Lua 之 前 会 先 执行 一 个 静默 (slient) 的 字典 序 排序 (lexicographical 

sorting)。 举 个 例子 ， 因 为 Redis 的 Set 保存 的 是 无 序 的 元 素 ， 所 以 在 Redis 
命令 行 客户 端 中 直接 执行 SMEMBERS ， 返 回 的 元 素 是 无 序 的 ， 但 是 ， 假 如 在 
脚本 中 执行 redis.call("smembers"，KEYS[1]) ， 那 么 返回 的 总 是 排 过 序 
的 元 素 。 

xt Lua 的 伪 随 机 数 生成 画 数 math.random 和 math.randomseed 进行 修 
改 ， 使 得 每 次 在 运行 新 脚本 的 时 候 ， 总 是 拥有 同样 的 seed 值 。 这 意味 着 ， 每 
次 运行 脚本 时 ， 只 要 不 使 用 math.randomseed ， 那 么 math.random 产生 
的 随机 数 序 列 总 是 相同 的 。 


尽管 有 那么 多 的 限制 ， 但 用 户 还 是 可 以 用 一 个 简单 的 技巧 写 出 带 随机 行为 的 脚本 (如 
果 他 们 需要 的 话 )。 


假设 现在 我 们 要 编写 一 个 Redis 脚本 ， 这 个 脚本 从 列表 中 弹出 N 个 随机 数 。 一 个 
Ruby 写 的 例子 如 下 : 


require 'rubygems' 
require 'redis' 


r = Redis.new 


RandomPushScript = <<EOF 
local i = tonumber (ARGV[1] ) 
local res 
while (i > 0) do 
res = redis.call('lpush',KEYS[1],math.random() ) 
i= i-1 
end 
return res 
EOF 


r.del(:mylist) 
puts r.eval(RandomPushScript, [:mylist],[10, rand(2**32) ] ) 


这 个 程序 每 次 运行 都 会 生成 带 有 以 下 元 素 的 列表 : 


> lrange mylist © -1 
1) "0.74509509873814" 
2) "0.87390407681181" 
3) "0.36876626981831" 
4) "0.6921941534114" 
5) "0.7857992587545" 
6) "0.57730350670279" 
7) "0.87046522734243" 
8) "0.09637165539729" 
9) "0.74990198051087" 
10) "0.17082803611217" 


上 面 的 Ruby 程序 每 次 都 只 生成 同样 的 列表 ， 用 途 并 不 是 太 大 。 那 么 ， 该 怎样 修改 
这 个 脚本 ， 使 得 它 仍然 是 一 个 纯 函 数 (符合 Redis 的 要 求 )， 但 是 每 次 调用 都 可 以 产 
生 不 同 的 随机 元 素 呢 ? 


一 个 简单 的 办 法 是 ， 为 脚本 添加 一 个 额外 的 参数 ， 让 这 个 参数 作为 Lua 的 随机 数 生 
成 器 的 seed 值 ， 这 样 的 话 ， 只 要 给 脚本 传人 不 同 的 seed ， 脚 本 就 会 生成 不 同 的 
列表 元 素 。 


以 下 是 修改 后 的 脚本 : 


RandomPushScript = <<EOF 
local i = tonumber (ARGV[1] ) 
local res 
math. randomseed(tonumber (ARGV[2] ) ) 
while (i > 0) do 
res = redis.call('lpush',KEYS[1],math.random() ) 
i = i-1 
end 
return res 
EOF 


r.del(:mylist) 
puts r.eval(RandomPushScript, 1, :mylist,10, rand(2**32) ) 


尽管 对 于 同样 的 seed, LAWAS > FhNRTRE-HN(AACE-TA 
数 )， 但 是 只 要 每 次 在 执行 脚本 的 时 候 传 人 不 同 的 seed ， 我 们 就 可 以 得 到 带 有 不 同 
随机 元 素 的 列表 。 


Seed 会 在 复制 (replication link) 和 写 AOF 文件 时 作为 一 个 参数 来 传播 ， 保 证 在 载 入 
AOF 文件 或 附属 节点 (slave) 人 处 理 脚本 时 ， seed 仍然 可 以 及 时 得 到 更 新 。 


注意 ，Redis 实现 保证 math.random 和 math.randomseed 的 输出 和 运行 
Redis 的 系统 架构 无 关 ， 无 论 是 32 位 还 是 64 位 系统 ， 无 论 是 小 端 (little endian) 还 
是 大 端 (big endian) 系 统 ， 这 两 个 函数 的 输出 总 是 相同 的 。 


全 局 变量 保护 


为 了 防止 不 必要 的 数据 泄漏 进 Lua 环境 ， Redis 脚本 不 允许 创建 全 局 变量 。 如 果 一 
个 脚本 需要 在 多 次 执行 之 间 维 持 某 种 状态 ， 它 应 该 使 用 Redis key 来 进行 状态 保 
存 。 

企图 在 脚本 中 访问 一 个 全 局 变量 (不 论 这 个 变量 是 否 存 在 ) 将 引起 脚本 停止 ， EVAL 
A 


图 
命令 会 返回 一 个 错误 : 

redis 127.0.0.1:6379> eval 'a=10' 0 

(error) ERR Error running script (call to f_933044db579a2f8fd45d80¢ 
SSS | 
Lua 的 debug 工具 ， 或 者 其 他 设施 ， 比 如 打印 (alter) 用 于 实现 全 局 保护 的 meta 
table ， 都 可 以 用 于 实现 全 局 变量 保护 。 


实现 全 局 变量 保护 并 不 难 ， 不 过 有 时 候 还 是 会 不 小 心 而 为 之 。 一 有 旦 用 户 在 脚本 中 混 
AT Lua 全 局 状态 ， 那 么 AOF 持久 化 和 复制 (replication) 都 会 无 法 保证 ， 所 以 ， 
请 不 要 使 用 全 局 变量 。 


避免 引入 全 局 变量 的 一 个 诀窍 是 : 将 脚本 中 用 到 的 所 有 变量 都 使 用 local 关键 字 
定义 为 局 部 变量 。 





库 


Redis 内 和 置 的 Lua 解释 器 加 载 了 以 下 Lua & : 


base 
table 
string 
math 
debug 
cjson 
cmsgpack 


其 中 cjson 库 可 以 让 Lua 以 非常 快 的 速度 处 理 JSON 数据 ， 除 此 之 外 ， 其 他 别 
的 都 是 Lua 的 标准 库 。 


每 个 Redis 实例 都 保证 会 加 载 上 面 列举 的 库 ， 从 而 确保 每 个 Redis 脚本 的 运行 环境 
都 是 相同 的 。 


使 用 脚本 散发 Redis 日 志 


在 Lua 脚本 中 ， 可 以 通过 调用 redis.log H&S Redis 日 志 (log) : 


redis.log(loglevel, message) 


其 中 ， message 参数 是 一 个 字符 串 ， 而 loglevel 参数 可 以 是 以 下 任意 一 个 
值 : 


redis.LOG_DEBUG 
redis.LOG_VERBOSE 
redis.LOG_NOTICE 
redis.LOG_WARNING 


上 面 的 这 些 等 级 (level) 和 标准 Redis 日 志 的 等 级 相对 应 。 


对 于 脚本 散发 (emit) 的 日 志 ， 只 有 那些 和 当前 Redis 实例 所 设置 的 日 志 等 级 相同 或 
更 高 级 的 日 志 才 会 被 散发 。 


以 下 是 一 个 日 志 示 例 : 

redis.log(redis.LOG_WARNING, "Something is wrong with this script." 
执行 上 面 的 函数 会 产生 这 样 的 信息 : 

[32343] 22 Mar 15:21:39 # Something is wrong with this script. 


沙 箱 (sandbox) 和 最 大 执行 时 间 


脚本 应 该 仅仅 用 于 传递 参数 和 对 Redis 数据 进行 处理 ， 它 不 应 该 党 试 去 访问 外 部 系 
统 (比如 文件 系统 )， 或 者 执行 任何 系统 调用 。 


除 此 之 外 ， 脚 本 还 有 一 个 最 大 执行 时 间 限 制 ， 它 的 默认 值 是 5 秒 钟 ， 一 般 正音 运作 
的 脚本 通常 可 以 在 几 分 之 几 毫 秒 之 内 完成 ， 花 不 了 那么 多 时 间 ， 这 个 限制 主要 是 为 
了 防止 因 编程 错误 而 造成 的 无 限 循环 而 设置 的 。 


最 大 执行 时 间 的 长 短 由 lua-time-1limit 选项 来 控制 (以 毫秒 为 单位 )， 可 以 通过 
编辑 redis.conf 文件 或 者 使 用 CONFIG GET 和 CONFIG SET 命令 来 修改 它 。 


当 一 个 脚本 达到 最 大 执行 时 间 的 时 候 ， 它 并 不 会 自动 被 Redis R, AA Redis 必 
须 保证 脚本 执行 的 原子 性 ， 而 中 途 停止 脚本 的 运行 意味 着 可 能 会 留 下 未 义理 完 的 数 
据 在 数据 集 (data set) 里 面 。 


因此 ， 当 脚本 运行 的 时 间 超 过 最 大 执行 时 间 后 ， 以 下 动作 会 被 执行 : 


e Redis 记录 一 个 脚本 正在 超时 运行 
Redis 开始 重新 接受 其 他 客户 端的 命令 请 求 ， 但 是 只 有 SCRIPT KILL 和 
SHUTDOWN NOSAVE 两 个 命令 会 被 处 理 ， 对 于 其 他 命令 请 求 ， Redis 服务 器 
只 是 简单 地 返回 BUSY 错误 。 
e 可 以 使 用 SCRIPT KILL 命令 将 一 个 仅 执 行 只 读 命令 的 脚本 杀 死 ， 因 为 只 读 
命令 并 不 修改 数据 ， 因 此 杀 死 这 个 脚本 并 不 破坏 数据 的 完整 性 
e。 如 果 脚 本 已 经 执行 过 写 命 售 ， 那 么 唯一 允许 执行 的 操作 就 是 
SHUTDOWN NOSAVE ， 它 通过 停止 服务 器 来 阻止 当前 数据 集 写 入 人 磁盘 


流水 线 (pipeline) 上 下 文 (context) 中 的 EVALSHA 

在 流水 线 请 求 的 上 下 文中 使 用 EVALSHA 命令 时 ， 要 特别 小 心 ， 因 为 在 流水 线 中 ， 
必须 保证 命令 的 执行 顺序 。 

一 旦 在 流水 线 中 因为 EVALSHA 命令 而 发 生 NOSCRIPT 错误 ， 那 么 这 个 流水 线 就 
再 也 没有 办 法 重新 执行 了 ， 否 则 的 话 ， 命 令 的 执行 顺序 就 会 被 打 乱 。 

为 了 防止 出 现 以 上 所 说 的 问题 ， 客 户 端 库 实 现 应 该 实施 以 下 的 其 中 一 项 措施 : 


。 总 是 在 流水 线 中 使 用 EVAL 命令 

e 检查 流水 线 中 要 用 到 的 所 有 命令 ， 找 到 其 中 的 EVAL 命令 ， 并 使 用 SCRIPT 
EXISTS 命令 检查 要 用 到 的 脚本 是 不 是 全 都 已 经 保存 在 缓存 里 面 了 。 如 果 所 需 
的 全 部 脚本 都 可 以 在 缓存 里 找到 ， 那 么 就 可 以 放心 地 将 所 有 EVAL 命令 改 成 
EVALSHA 命令 ， 否 则 的 话 ， 就 要 在 流水 线 的 顶端 (top) 将 缺少 的 脚本 用 
SCRIPT LOAD 命令 加 上 去 。 


可 用 版 本 : 
>= 2.6.0 
时 间 复 条 度 : 


EVAL 和 EVALSHA 可 以 在 O(1) 复 条 度 内 找到 要 被 执行 的 脚本 ， 其 余 的 复杂 度 取决 
于 执行 的 脚本 本 身 。 


EVALSHA 


EVALSHA sha1 numkeys key [key ...] arg [arg ...] 
根据 给 定 的 shat 校 验 码 ， 对 缓存 在 服务 器 中 的 脚本 进行 求 值 。 
将 脚本 缓存 到 服务 器 的 操作 可 以 通过 SCRIPT LOAD 命令 进行 。 
这 个 命令 的 其 他 地 方 ， 比 如 参数 的 传人 方式 ， 都 和 EVAL 命令 一 样 。 
可 用 版 本 : 
>= 2.6.0 
时 间 复 条 度 : 
根据 脚本 的 复杂 度 而 定 。 


redis> SCRIPT LOAD "return 'hello moto'" 
"232fd51614574c f0867b83d384a5e898cfd24e5a" 


redis> EVALSHA "232fd51614574cf0867b83d384a5e898cfd24e5a" 0 
"hello moto" 


SCRIPT EXISTS 


SCRIPT EXISTS script [script ...] 


给 定 一 个 或 多 个 脚本 的 SHA1 校 验 和 ， 返 回 一 个 包含 o 和 1 的 列表 ， 表 示 校 
验 和 所 指定 的 脚本 是 否 已 经 被 保存 在 缓存 当中 。 


关于 使 用 Redis 对 Lua 脚本 进行 求 值 的 更 多 信息 ， 请 参见 EVAL RR 
可 用 版 本 : 

>= 2.6.0 

时 间 复 末 度 : 

O(N), N 为 给 定 的 SHA1 校 验 和 的 数量 。 

返回 值 : 


一 个 列表 ， 包 含 0 和 1 ， 前 者 表示 脚本 不 存在 于 缓存 ， 后 者 表示 脚本 已 经 在 缓 
存 里 面 了 。 列 表 中 的 元 素 和 给 定 的 SHA1 校 验 和 保持 对 应 关系 ， 比 如 列表 的 第 三 个 
元 素 的 值 就 表示 第 三 个 SHA1 校 验 和 所 指定 的 脚本 在 缓存 中 的 状态 。 


redis> SCRIPT LOAD "return 'hello moto'" # 载 人 一 个 脚本 
"232fd51614574cf0867b83d384a5e898cfd24e5a" 


redis> SCRIPT EXISTS 232fd51614574cf0867b83d384a5e898cfd24e5a 
1) (integer) 1 


redis> SCRIPT FLUSH # 清空 缓存 
OK 


redis> SCRIPT EXISTS 232fd51614574cf0867b83d384a5e898cfd24e5a 
1) (integer) 0 


SCRIPT FLUSH 


SCRIPT FLUSH 

清除 所 有 Lua 脚本 缓存 。 

关于 使 用 Redis 对 Lua 脚本 进行 求 值 的 更 多 信息 ， 请 参 
可 用 版 本 : 


>= 2.6.0 

SRE : 

O(N), N 为 缓存 中 脚本 的 数量 。 
VR lo) (6 

总 是 返回 OK 


redis> SCRIPT FLUSH 
OK 


Ss 


SCRIPT KILL 


SCRIPT KILL 


杀 死 当前 正在 运行 的 Lua 脚本 ， 当 且 仅 当 这 个 脚本 没有 执行 过 任何 写 操 作 时 ， 这 个 
any EM. 


ee eet asa 长 的 脚本 ， 比 如 一 个 因为 BUG 而 发 生 无 限 loop 
的 脚本 ， 诸 如 此 类 


SCRIPT KILL 执行 之 后 ， 当 前 正在 运行 的 脚本 会 被 杀 死 ， 执 行 这 个 脚本 的 客户 端 会 
从 EVAL 命令 的 阻塞 当中 退出 ， 并 收 到 一 个 错误 作为 返回 值 。 


另 一 方面 ， 假 如 当前 正在 运行 的 脚本 已 经 执行 过 写 操 作 ， 那 么 即使 执行 SCRIPT 
KILL ， 也 无 法 将 它 杀 死 ， 因 为 这 是 违反 Lua 脚本 的 原子 性 执行 原则 的 。 在 这 种 情 
况 下 ， 唯 一 可 行 的 办 法 是 使 用 SHUTDOWN NOSAVE 命令 ， 通 过 停止 整个 Redis 进 
程 来 停止 脚本 的 运行 ， 并 防止 不 完整 (half-written) 的 信息 被 宇和 数据库 中 。 


关于 使 用 Redis 对 Lua 脚本 进行 求 值 的 更 多 信息 ， 请 参见 EVAL OT. 
可 用 版 本 : 

>= 2.6.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

执行 成 功 返 回 ok ， 否 则 返回 一 个 错误 。 


# 没有 脚本 在 执行 时 


redis> SCRIPT KILL 
(error) ERR No scripts in execution right now. 


# 成 功 杀 死 脚 本 时 


redis> SCRIPT KILL 
OK 
(1.30s) 


# ŽRDE AWT RFA, Ke 
redis> SCRIPT KILL 
(error) ERR Sorry the script already executed write commands again: 


(1.69s) 
4 i D 











以 下 是 脚本 被 杀 死 之 后 ， 返 回 给 执行 脚本 的 客户 端的 错误 : 


redis> EVAL "while true do end" 0 
(error) ERR Error running script (call to f_694a5feiddb97a4c6aibf2: 
(5.00s) 


‘| _ : 








SCRIPT LOAD 


SCRIPT LOAD script 

将 脚本 script 添加 到 脚本 缓存 中 ， 但 并 不 立即 执行 这 个 脚本 。 

EVAL 命令 也 会 将 脚本 添加 到 脚本 缓存 中 ， 但 是 它 会 立即 对 输入 的 脚本 进行 求 值 。 
如 果 给 定 的 脚本 已 经 在 缓存 里 面 了 ， 那 么 不 做 动作 。 


在 脚本 被 加 入 到 缓存 之 后 ， 通 过 EVALSHA 命令 ， 可 以 使 用 脚本 的 SHA1 校 验 和 来 
调用 这 个 脚本 。 


脚本 可 以 在 缓存 中 保留 无 限 长 的 时 间 ， 直 到 执行 SCRIPT FLUSH 为 止 。 
关于 使 用 Redis 对 Lua 脚本 进行 求 值 的 更 多 信息 ， 请 参见 EVAL MD. 
可 用 版 本 : 
>= 2.6.0 
时 间 复 杂 度 : 
O(N), N 为 脚本 的 长 度 (以 字 节 为 单位 )。 
返回 值 : 
给 定 script 的 SHA1 校 验 和 
redis> SCRIPT LOAD "return 'hello moto'" 
"232Fd51614574cf0867b83d384a5e898c Fd24e5a" 


redis> EVALSHA 232fd51614574cf0867b83d384a5e898cfd24e5a 0 
"hello moto" 


Connection (连接 ) 


AUTH 


AUTH password 


通过 设置 配置 文件 中 requirepass 项 的 值 (使 用 命令 
CONFIG SET requirepass password )， 可 以 使 用 密码 来 保护 Redis 服务 器 。 


如 果 开 启 了 密码 保护 的 话 ， 在 每 次 连接 Redis 服务 器 之 后 ， 就 要 使 用 AUTH MS 
解锁 ， 解 锁 之 后 才能 使 用 其 他 Redis 命 今 。 


如 果 AUTH 命令 给 定 的 密码 password 和 配置 文件 中 的 密码 相符 的 话 ， 服 务 器 
会 返回 ok 并 开始 接受 命令 输入 。 


另 一 方面 ， 假 如 密码 不 匹配 的 话 ， 服 务 器 料 返 回 一 个 错误 ， 并 要 求 客 户 端 需 重新 输 
入 密码 。 


Warning 


因为 Redis 高 性 能 的 特点 ， 在 很 短 时 间 内 尝试 猜测 非常 多 个 密码 是 有 可 能 的 ， 因 此 
请 确保 使 用 的 密码 足够 复 休 和 足够 长 ， 以 免 遭 受 密码 猜测 攻击 。 


可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

密码 匹配 时 返回 ok ， 否 则 返回 一 个 错误 。 


# 设置 密码 


redis> CONFIG SET requirepass secret_password 


OK 


redis> QUIT 


[huangz@mypad]$ redis 


redis> PING 
(error) ERR 


redis> AUTH 
(error) ERR 


redis> AUTH 
OK 


redis> PING 
PONG 


# 清空 密码 


redis> CONFIG SET requirepass "" # 通过 将 密码 i 


OK 
redis> QUIT 
$ redis 


redis> PING 
PONG 


operation not permitted 


wrong_password_ testing 
invalid password 


secret_password 


# 执行 命令 不 


# 将 密码 设置 为 secret 


# 退出 再 连接 ， 让 新 密码 


# 未 验证 密码 ， 操 作 被 拒 


H 尝试 输入 错误 的 密码 


# 输入 正确 的 密码 


# 密码 验证 成 功 ， 可 以 正 


户 端 


再 需要 密码 ， 清 空 密码 操作 拟 





ECHO 


ECHO message 

打印 一 个 特定 的 信息 message ， 测 试 时 使 用 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

message 自身 。 


redis> ECHO "Hello Moto" 
"Hello Moto" 


redis> ECHO "Goodbye Moto" 
"Goodbye Moto" 


PING 


PING 


使 用 客户 端 向 Redis 服务 器 发 送 一 个 PING ， 如 果 服 务 器 运作 正常 的 话 ， 会 返回 
一 个 PONG 。 


通常 用 于 测试 与 服务 器 的 连接 是 否 仍然 生效 ， 或 者 用 于 测量 延迟 值 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

如 果 连 接 正常 就 返回 一 个 PONG ， 否 则 返回 一 个 连接 错误 。 


# 客户 端 和 服务 器 连接 正常 


redis> PING 
PONG 


# 客户 端 和 服务 器 连接 不 正常 (网 络 不 正常 或 服务 器 未 能 正常 运行 ) 


redis 127.0.0.1:6379> PING 
Could not connect to Redis at 127.0.0.1:6379: Connection refused 


QUIT 


QUIT 

请 求 服务 器 关闭 与 当前 客户 端的 连接 。 

一 旦 所 有 等 待 中 的 回复 (如 果 有 的 话 ) 顺 利 写 人 到 客户 端 ， 连 接 就 会 被 关闭 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 


` 


总 是 返回 ok (但 是 不 会 被 打印 显示 ， 因 为 当时 Redis-cli 已 经 退出 )。 


$ redis 
redis> QUIT 


$ 


SELECT 


SELECT index 


切换 到 指定 的 数据 库 ， 数 据 库 素 引 号 index 用 数字 值 指定 ， 以 o 作为 起 始 索 


引 值 。 

默认 使 用 9 号 数据 库 。 
可 用 版 本 : 

>= 1.0.0 

a SAE: 

O(1) 

返回 值 : 

OK 


redis> SET db_number 0 
OK 


redis> SELECT 1 
OK 


redis[1]> GET db_number 
(nil) 


redis[1]> SET db_number 1 
OK 


redis[1]> GET db_number 
ie MU 


redis[1]> SELECT 3 
OK 


redis[3]> 


E a 5 


# 默认 使 用 9 号 数据 库 


# 使 用 1 号 数据 库 


# 已 经 切换 到 1 号 数据 库 ， 注 意 Redis 现在 


# 再 切换 到 3 号 数据 库 


# 提示 符 从 [1] 改变 成 了 [3] 





Server (fk 44s) 


BGREWRITEAOF 


BGREWRITEAOF 
执行 一 个 AOF 文 件 重 写 操作 。 重 写 会 创建 一 个 当前 AOF 文件 的 体积 优化 版 本 。 


即使 BGREWRITEAOF 执行 失败 ， 也 不 会 有 任何 数据 丢失 ， 因 为 旧 的 AOF 文件 在 
BGREWRITEAOF 成 功 之 前 不 会 被 修改 。 


重 写 操作 只 会 在 没有 其 他 持久 化 工作 在 后 台 执 行 时 被 触发 ， 也 就 是 说 : 


e 如 果 Redis 的 子 进 程 正在 执行 快照 的 保存 工作 ， 那 么 AOF 重 写 的 操作 会 被 预 
定 (scheduled)， 等 到 保存 工作 完成 之 后 再 执行 AOF 重 写 。 在 这 种 情况 下 ， 
BGREWRITEAOF 的 返回 值 仍然 是 ok ， 但 还 会 加 上 一 条 额外 的 信息 ， 说 明 
BGREWRITEAOF 要 等 到 保存 操作 完成 之 后 才能 执行 。 在 Redis 2.6 或 以 上 的 
版 本 ， 可 以 使 用 NFO 命令 查看 BGREWRITEAOF 是 否 被 预定 。 

e 如 果 已 经 有 别 的 AOF 文件 重 写 在 执行 ， 那 么 BGREWRITEAOF 返回 一 个 错 
误 ， 并 且 这 个 新 的 BGREWRITEAOF 请 求 也 不 会 被 预定 到 下 次 执行 。 


从 Redis 2.4 开始 ， AOF 重 写 由 Redis 自行 触发 ，BGREWRITEAOF 仅仅 用 于 手 
ihe BERLE, 


请 移 步 持久 化 文档 (英文 ) 查看 更 多 相关 细节 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(N), N 为 要 追加 到 AOF 文件 中 的 数据 数量 。 
返回 值 : 

反馈 信息 。 


redis> BGREWRITEAOF 
Background append only file rewriting started 


BGSAVE 


ERER (Asynchronously (RF 4 BBE A BE ET & o 


BGSAVE 命令 执行 之 后 立即 返回 ok ， 然 后 Redis fork 出 一 个 新 子 进程 ， 原 来 的 
Redis 进程 ( 父 进 程 ) 继 续 义 理 客 户 端 请 求 ， 而 子 进程 则 负责 将 数据 保存 到 磁盘 ， 然 
后 退出 。 


客户 端 可 以 通过 LASTSAVE 命令 查看 相关 信息 ， 判 断 BGSAVE 命令 是 否 执行 成 
功 。 


请 移 步 持久 化 文档 查看 更 多 相关 细节 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(N), AN 为 要 保存 到 数据 库 中 的 key 的 数量 。 
Wl) a : 

反馈 信息 。 


redis> BGSAVE 
Background saving started 


CLIENT GETNAME 


CLIENT GETNAME 
返回 CLIENT SETNAME 命令 为 连接 设置 的 名 字 。 


因为 新 创建 的 连接 默认 是 没有 名 字 的 ， 对 于 没有 名 字 的 连接 ， CLIENT GETNAME 
返回 空白 回复 。 


可 用 版 本 

>= 2.6.9 

时 间 复 条 度 

O(1) 

返回 值 

如 果 连 接 没 有 设置 名 字 ， 那 么 返回 空白 回复 ; 如 果 有 设置 名 字 ， 那 么 返回 名 字 。 


# 新 连接 默认 没有 名 字 


redis 127.0.0.1:6379> CLIENT GETNAME 
(nil) 


# 设置 名 字 


redis 127.0.0.1:6379> CLIENT SETNAME hello-world-connection 
OK 


# 返回 名 字 


redis 127.0.0.1:6379> CLIENT GETNAME 
"hello-world-connection" 


CLIENT KILL 


CLIENT KILL ip:port 
关闭 地 址 为 ip:port 的 客户 端 。 
ip:port 应 该 和 CLIENT LIST 命令 输出 的 其 中 一 行 匹 配 。 


人 
断 开 连 接 。 


如 果 要 被 断 开 连 接 的 客户 端正 在 执行 命 售 ， 那 么 当 这 个 命令 执行 之 后 ， 在 发 送 下 一 
个 命令 的 时 候 ， 它 就 会 收 到 一 个 网 络 错误 ， 告 知 它 自身 的 连接 已 被 关闭 。 


可 用 版 本 

>= 2.4.0 

时 间 复 条 度 

O(N), N 为 已 连接 的 客户 端 数量 。 

WR [El 

当 指定 的 客户 端 存在 ， 且 被 成 功 关 闭 时 ， 返 回 OK 。 


# 列 出 所 有 已 连接 客户 端 


redis 127.0.0.1:6379> CLIENT LIST 
addr=127.0.0.1:43501 fd=5 age=10 idle=0 flags=N db=0 sub=0 psub=0 r 


# 杀 死 当前 客户 端的 连接 


redis 127.0.0.1:6379> CLIENT KILL 127.0.0.1:43501 
OK 


# 之 前 的 连接 已 经 被 关闭 ，CLI 客户 端 又 重新 建立 了 连接 
# 之 前 的 端口 是 43501 ， 现 在 是 43504 


redis 127.0.0.1:6379> CLIENT LIST 
addr=127.0.0.1:43504 fd=5 age=0 idle=0 flags=N db=0 sub=0 psub=0 mt 


E 





CLIENT LIST 


CLIENT LIST 
以 人 类 可 读 的 格式 ， 返 回 所 有 连接 到 服务 器 的 客户 端 信息 和 统计 数据 。 


redis> CLIENT LIST 

addr=127.0.0.1:43143 fd=6 age=183 idle=0 flags=N db=0 sub=0 psub=0 
addr=127.0.0.1:43163 fd=5 age=35 idle=15 flags=N db=0 sub=0 psub=0 
addr=127.0.0.1:43167 fd=7 age=24 idle=6 flags=N db=0 Sub=0 psub=0 r 


[i 


| 





可 用 版 本 
>= 2.4.0 
时 间 复 条 度 


A 


), N 为 连接 到 服务 器 的 客户 端 数量 。 
返回 值 
p 


AA 
T 


返回 多 行 字符 串 ， 这 些 字 符 串 按 以 下 形式 被 格式 化 : 


每 个 已 连接 客户 端 对 应 一 行 〈 以 LF 分 割 ) 
每 行 字 符 串 由 一 系列 属性 = 值 形式 的 域 组 成 ， 每 个 域 之 间 以 空格 分 开 


以 下 是 域 的 含义 : 
e addr : 客户 端的 地 址 和 端口 
e fd : 套 接 字 所 使 用 的 文件 描述 符 
e age : 以 秒 计算 的 已 连接 时 长 
e idle : 以 秒 计算 的 空闲 时 长 
e flags : 客户 端 flag ( 见 下 文 ) 
e db : 该 客户 端正 在 使 用 的 数据 库 ID 
e sub : 已 订阅 频道 的 数量 
e psub : 已 订阅 模式 的 数量 
e multi : 在 事务 中 被 执行 的 命令 数量 
e qbuf : 查询 缓冲 区 的 长 度 〈 字 节 为 单位 ， 6 表示 没有 分 配 查询 缓冲 区 ) 
e qbuf-free : 查询 缓冲 区 剩余 空间 的 长 度 〈 字 节 为 单位 ， 9 表示 没有 剩 


余 空 间 ) 

obl : 输出 缓冲 区 的 长 度 〈 字 节 为 单位 ， 9 表示 没有 分 配 输出 缓冲 区 ) 
oll : 输出 列表 包含 的 对 象 数 量 〈 当 输出 缓冲 区 没有 剩余 空间 时 ， 命 令 回 复 
会 以 字符 串 对 象 的 形式 被 入 队 到 这 个 队列 里 ) 

omem : 输出 缓冲 区 和 输出 列表 占用 的 内 存 总 量 

events : 文件 描述 符 事件 〈 见 下 文 ) 


cmd : 最 近 一 次 执行 的 命令 


客户 端 flag 可 以 由 以 下 部 分 组 成 : 


0 : & Pitz MONITOR 模式 下 的 附属 节点 (slave) 

S : A Pime Aitan F (normal) 的 附属 节点 

M : 客户 端 是 主 节 点 (master) 

x : 客户 端正 在 执行 事务 

b : 客户 端正 在 等 待 阻 塞 事件 

i :客户 端正 在 等 待 VM 1/O 操作 (GAR) 

d : 一 个 受 监 视 (watched) 的 键 已 被 修改 ， EXEC 命令 将 失败 
c ;在 将 回复 完整 地 写 出 之 后 ， 关 闭 链接 

u :客户 端 未 被 阻塞 (unblocked) 
A : 尽 可 能 快 地 关闭 连接 
N :未 设置 任何 flag 


文件 描述 符 事件 可 以 是 : 


e r :客户 端 套 接 字 (在 事件 loop 中 ) 是 可 读 的 (readable) 
e w :客户 端 套 接 字 (在 事件 loop 中 ) 是 可 写 的 (writeable) 


Note 


AT debug 的 需要 ， 经 常会 对 域 进行 添加 和 删除 ， 一 个 安全 的 Redis 客户 端 应 该 
可 以 对 CLIENT LIST 的 输出 进行 相应 的 处 理 (parse) ， 比 如 忽略 不 存在 的 域 ， 
跳 过 未 知 域 ， 诸 如 此 类 。 


CLIENT SETNAME 


CLIENT SETNAME connection-name 
为 当前 连接 分 配 一 个 名 字 。 


这 个 名 字 会 显示 在 CLIENT LIST 命令 的 结果 中 ， 用 于 识别 当前 正在 与 服务 器 进行 
连接 的 客户 端 。 


举 个 例子 ， 在 使 用 Redis 构建 队列 (queue) 时 ， 可 以 根据 连接 负责 的 任务 
(role) ， 为 信息 生产 者 (producer) 和 信息 消费 者 (consumer) 分 别 设置 不 同 的 
名 字 。 


名 字 使 用 Redis 的 字符 串 类 型 来 保存 ， 最 大 可 以 占用 512 MB 。 另外 ， 为 了 避免 
和 CLIENT LIST 命令 的 输出 格式 发 生 冲 突 ， 名 字 里 不 允许 使 用 空格 。 


要 移 除 一 个 连接 的 名 字 ， 可 以 将 连接 的 名 字 设 为 空 字符 串 "" 。 
使 用 CLIENT GETNAME 命令 可 以 取出 连接 的 名 字 。 

新 创建 的 连接 默认 是 没有 名 字 的 。 

Tip 

在 Redis 应 用 程序 发 生 连 接 泄 漏 时 ， 为 连接 设置 名 字 是 一 种 很 好 的 debug 手段 。 
可 用 版 本 

>= 2.6.9 

时 间 复 条 度 

O(1) 

返回 值 

设置 成 功 时 返回 OK o 


# 新 连接 默认 没有 名 字 


redis 127.0.0.1:6379> CLIENT GETNAME 
(nil) 


# 设置 名 字 


redis 127.0.0.1:6379> CLIENT SETNAME hello-world-connection 
OK 


# 返回 名 字 


redis 127.0.0.1:6379> CLIENT GETNAME 
"hello-world-connection" 


# 在 客户 端 列 表 中 查看 


redis 127.0.0.1:6379> CLIENT LIST 
addr=127.0.0.1:36851 

fd=5 

name=hello-world-connection # <- 名 字 
age=51 


# 清除 名 字 


redis 127.0.0.1:6379> CLIENT SETNAME # 只 用 空格 是 不 行 的 |! 
(error) ERR Syntax error, try CLIENT (LIST | KILL ip:port) 
redis 127.0.0.1:6379> CLIENT SETNAME "" # 必须 双 引 号 显示 包围 
OK 

redis 127.0.0.1:6379> CLIENT GETNAME # 清除 完毕 


(nil) 


CONFIG GET 


CONFIG GET parameter 


CONFIG GET 命令 用 于 取得 运行 中 的 Redis 服务 器 的 配置 参数 (configuration 
parameters), {E Redis 2.4 版 本 中 ， 有 部 分 参数 没有 办 法 用 CONFIG GET if 
问 ， 但 是 在 最 新 的 Redis 2.6 版 本 中 ， 所 有 配置 参数 都 已 经 可 以 用 CONFIG GET 
访问 了 。 

CONFIG GET 接受 单个 参数 parameter 作为 搜索 关键 字 ， 查 找 所 有 匹配 的 配置 
参数 ， 其 中 参数 和 值 以 “ 键 - 值 对 ”(key-value pairs) 的 方式 排列 。 


比如 执行 CONFIG GET s* 命令 ， 服 务 器 就 会 返回 所 有 以 s 开头 的 配置 参数 及 
参数 的 值 : 


redis> CONFIG GET s* 


1) "save" # 参数 名 : save 

2) "900 1 300 10 60 10000" # save 参数 的 值 

3) "slave-serve-stale-data" # 参数 名 : slave-serve-stale-data 
4) "yes" # slave-serve-stale-data 参数 的 值 
5) "set-max-intset-entries" TETS 

6) UIE ah 

7) "slowlog-log-slower-than" 

8) "1000" 

9) "slowlog-max-len" 

10) "1000" 


如 果 你 只 是 寻找 特定 的 某 个 参数 的 话 ， 你 当然 也 可 以 直接 指定 参数 的 名 字 : 


redis> CONFIG GET slowlog-max-len 
1) "slowlog-max-len" 
2) "1000" 


使 用 命令 CONFIG GET * ， 可 以 列 出 CONFIG GET 命令 支持 的 所 有 参数 : 


redis> CONFIG GET * 


1) "dir" 

2) "/var/lib/redis" 
3) "dbfilename" 

4) "dump. rdb" 

5) "requirepass" 

6) (nil) 

7) "masterauth" 

8) (nil) 

9) "maxmemory" 

10) "o" 


11) "maxmemory-policy" 
12) "volatile-lru" 
13) "maxmemory-samples" 


14) MEDU 

15) "timeout" 
16) "o" 

17) "appendonly" 
18) "no" 

# 


49) "loglevel" 
50) "verbose" 


所 有 


被 CONFIG SET 所 支持 的 配置 参数 都 可 以 在 配置 文件 redis.conf 中 找到 ， 不 


过 CONFIG GET 和 CONFIG SET 使 用 的 格式 和 redis.conf 文件 所 使 用 的 格式 有 
以 下 两 点 不 同 : 


可 用 


10kb 、 2gb 这 些 在 配置 文件 中 所 使 用 的 储存 单位 缩写 ， 不 可 以 用 在 
CONFIG 命令 中 ， CONFIG SET 的 值 只 能 通过 数字 值 显 式 地 设 定 。 像 
CONFIG SET xxx 1k 这 样 的 命令 是 错误 的 ， 正 确 的 格式 是 

CONFIG SET xxx 1000 。 

save 选项 在 redis.conf 中 是 用 多 行文 字 储存 的 ， 但 在 CONFIG GET 命 兮 
中 ， 它 只 打印 一 行文 字 。 以 下 是 save 选项 在 redis.conf 文件 中 的 表 

示 : save 900 1``save 300 10``save 60 10000 但 是 CONFIG GET MP 
的 输出 只 有 一 

ÍT: redis&gt; CONFIG GET save 1) "save" ‘2) "900 1 300 10 60 10 
上 面 save 参数 的 三 个 值 表 示 : 在 900 PARDA 1 个 key 被 改动 ， 或 者 
300 秒 内 最 少 有 10 个 key 被 改动 ， 又 或 者 60 秒 内 最 少 有 1000 个 key 被 改 
动 ， 以 上 三 个 条 件 随便 满足 一 个 ， 就 触发 一 次 保存 操作 。 


版 本 : 


>= 2.0.0 


时 间 


BRE: 


不 明确 
返回 值 : 
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CONFIG GET 273 


CONFIG RESETSTAT 


CONFIG RESETSTAT 
Be /NFO 命令 中 的 某 些 统计 数据 ， 包 括 : 


Keyspace hits ( 键 空 间 命 中 次 数 ) 

Keyspace misses ( 键 空间 不 命中 次 数 ) 

Number of commands processed (执行 命令 的 次 数 ) 

Number of connections received (连接 服务 器 的 次 数 ) 

Number of expired keys (过 期 key 的 数量 ) 

Number of rejected connections (被 拒绝 的 连接 数量 ) 

Latest fork(2) time( 最 后 执行 fork(2) 的 时 间 ) 

The aof_ delayed_fsync counter( aof_delayed_fsync 计数 器 的 值 ) 


可 用 版 本 : 
>= 2.0.0 


redis 127.0.0.1:6379> INFO 
# Server 
redis_version:2.5.3 
redis_git_sha1:d0407c2d 
redis_git_dirty:0 
arch_bits:32 
multiplexing_api:epoll 
gcc_version:4.6.3 
process_id:11095 
run_id:efif6b6c7392e52d6001eaf777acbe547d1192e2 
tcp_port:6379 
uptime_in_seconds:6 
uptime_in_days:0 
lru_clock:1205426 


# Clients 
connected_clients:1 
client_longest_output_list:0 
client_biggest_input_buf:0 
blocked_clients:0 


# Memory 

used_memory: 331076 
used_memory_human: 323.32K 
used_memory_rss:1568768 
used_memory_peak: 293424 
used_memory_peak_human:286.55K 
used_memory_lua:16384 
mem_fragmentation_ratio:4.74 
mem_allocator:jemalloc-2.2.5 


# Persistence 

loading:0 

aof_enabled:0 
changes_since_last_save:0 
bgsave_in_progress:0 
last_save_time:1333260015 
last_bgsave_status:ok 
bgrewriteaof_in_progress:0 


# Stats 
total_connections_received:1 
total_commands_processed:0 
instantaneous_ops_per_sec:0 
rejected_connections:0 
expired_keys:0 
evicted_keys:0 
keyspace_hits:0 
keyspace_misses:0 
pubsub_channels:0 
pubsub_patterns:0 
latest_fork_usec:0 


# Replication 
role:master 
connected_slaves:0 


# CPU 

used_cpu_sys:0.01 
used_cpu_user:0.00 
used_cpu_sys_children:0.00 
used_cpu_user_children:0.00 


# Keyspace 
db0O: keys=20, expires=0 


# BS 


redis 127.0.0.1:6379> CONFIG RESETSTAT 
OK 


# BEI 


redis 127.0.0.1:6379> INFO 


# Server 
redis_version:2.5.3 
redis_git_sha1:d0407c2d 
redis_git_dirty:0 
arch_bits:32 
multiplexing_api:epoll 
gcc_version:4.6.3 
process_id:11095 
run_id:efif6b6c7392e52d6001eaf777acbe547d1192e2 
tcp_port:6379 
uptime_in_seconds:134 
uptime_in_days:0 
lru_clock:1205438 


# Clients 
connected_clients:1 
client_longest_output_list:0 
client_biggest_input_buf:0 
blocked_clients:0 


# Memory 

used_memory: 331076 
used_memory_human: 323.32K 
used_memory_rss:1568768 
used_memory_peak: 330280 
used_memory_peak_human:322.54K 
used_memory_lua:16384 
mem_fragmentation_ratio:4.74 
mem_allocator:jemalloc-2.2.5 


# Persistence 

loading:0 

aof_enabled:0 
changes_since_last_save:0 
bgsave_in_progress:0 
last_save_time:1333260015 
last_bgsave_status:ok 
bgrewriteaof_in_progress:0 


# Stats 
total_connections_received:0 
total_commands_processed:1 
instantaneous_ops_per_sec:0 
rejected_connections:0 
expired_keys:0 
evicted_keys:0 
keyspace_hits:0 
keyspace_misses:0 
pubsub_channels:0 
pubsub_patterns:0 
latest_fork_usec:0 


# Replication 


role:master 
connected_slaves:0 


# CPU 

used_cpu_sys:0.05 
used_cpu_user:0.02 
used_cpu_sys_children:0.00 
used_cpu_user_children:0.00 


# Keyspace 
db0: keys=20, expires=0 


CONFIG REWRITE 


CONFIG REWRITE 


CONFIG REWRITE 命令 对 启动 Redis 服务 器 时 所 指定 的 redis.conf 文件 进行 
改写 : 因为 CONFIG SET 命令 可 以 对 服务 器 的 当前 配置 进行 修改 ， 而 修改 后 的 配 
置 可 能 和 redis.conf 文件 中 所 描述 的 配置 不 一 样 ， CONFIG REWRITE 的 作用 
就 是 通过 尽 可 能 少 的 修改 ， 将 服务 器 当前 所 使 用 的 配置 记录 到 redis.conf 文件 
中 。 


重 写 会 以 非常 保守 的 方式 进行 : 


e JRA redis.conf 文件 的 整体 结构 和 注释 会 被 尽 可 能 地 保留 。 

e。 如 果 一 个 选项 已 经 存在 于 原 有 redis.conf 文件 中 ， 那么 对 该 选项 的 重 写 
会 在 选项 原本 所 在 的 位 置 (475) 上 进行 。 

e 如 果 一 个 选项 不 存在 于 原 有 redis.conf MAH, 并 且 该 选项 被 设置 为 默认 
值 ， 那么 重 写 程 序 不 会 将 这 个 选项 添加 到 重 写 后 的 redis.conf 文件 中 。 

e。 如 果 一 个 选项 不 存在 于 原 有 redis.conf 文件 中 ， 并 且 该 选项 被 设置 为 非 默 
认 值 ， 那么 这 个 选项 将 被 添加 到 重 写 后 的 redis.conf 文件 的 末尾 。 

e 未 使 用 的 行 会 被 留 白 。 比如 说 ， 如 果 你 在 原 有 redis.conf 文件 上 设置 了 
数 个 关于 save 选项 的 参数 ， 但 现在 你 将 这 些 save 参数 的 一 个 或 全 部 都 
关闭 了 ， 那么 这 些 不 再 使 用 的 参数 原本 所 在 的 行 就 会 变 成 空白 的 。 


即使 启动 服务 器 时 所 指定 的 redis.conf 文件 已 经 不 再 存在 ， CONFIG 
REWRITE 命令 也 可 以 重新 构建 并 生成 出 一 个 新 的 redis.conf 文件 。 


另 一 方面 ， 如 果 和 启动 服务 器 时 没有 裁 入 redis.conf 文件 ， 那么 执行 CONFIG 
REWRITE 命令 将 引发 一 个 错误 。 


原子 性 重 写 


对 redis.conf 文件 的 重 写 是 原子 性 的 ， 并 且 是 一 致 的 : 如 果 重 写 出 错 或 重 写 
期 间 服 务 器 月 涡 ， 那么 重 写 失 败 ， 原 有 redis.conf 文件 不 会 被 修改 。 如 果 重 
写成 功 ， 那么 redis.conf 文件 为 重 写 后 的 新 文件 。 


可 用 版 本 


>= 2.8.0 


RIE) (6 


一 个 状态 值 : 如 果 配 置 重 写成 功 则 返回 ok ， 失 败 则 返回 一 个 错误 。 


测试 


以 下 是 执行 CONFIG REWRITE 前 ， 被 载 人 到 Redis 服务 器 的 redis.conf X 
件 中 关于 appendonly 选项 的 设置 : 


# ,,， 其 他 选项 
appendonly no 


# ,,， 其 他 选项 


在 执行 以 下 命令 之 后 : 


127.0.0.1:6379> CONFIG GET appendonly # appendonly 处于 关 | 
1) "appendonly" 

2) "ho" 

127.0.0.1:6379> CONFIG SET appendonly yes # 打开 appendonly 
OK 


127.0.0.1:6379> CONFIG GET appendonly 
1) "appendonly" 


127.0.0.1:6379> CONFIG REWRITE # 将 appendonly J% 
OK 


SSE 
BERR redis.conf 文件 中 的 appendonly mies : 





# ,,， 其 他 选项 
appendonly yes 


# ,,， 其 他 选项 


CONFIG SET 


CONFIG SET parameter value 


CONFIG SET 命令 可 以 动态 地 调整 Redis 服务 器 的 配置 (configuration) 而 无 须 重 
Bo 


你 可 以 使 用 它 修改 配置 参数 ， 或 者 改变 Redis 的 持久 化 (Persistence) 方 式 。 


CONFIG SET 可 以 修改 的 配置 参数 可 以 使 用 命令 CONFIG GET * 来 列 出 ， 所 有 
被 CONFIG SET 修改 的 配置 参数 都 会 立即 生效 。 


关于 CONFIG SET 命令 的 更 多 消息 ， 请 参见 命令 CONFIG GET 的 说 明 。 


关于 如 何 使 用 CONFIG SET 命令 修改 Redis 持久 化 方式 ， 请 参见 Redis 
Persistence 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

不 明确 

返回 值 : 

当 设 置 成 功 时 返回 ok ， 否 则 返回 一 个 错误 。 
redis> CONFIG GET slowlog-max-len 


1) "slowlog-max-len" 
2) "1024" 


redis> CONFIG SET slowlog-max-len 10086 
OK 


redis> CONFIG GET slowlog-max-len 
1) "slowlog-max-len" 
2) "10086" 


DBSIZE 


DBSIZE 

返回 当前 数据 库 的 key 的 数量 。 

可 用 版 本 : 

>= 1.0.0 

BY a] RAE: 

O(1) 

返回 值 : 

当前 数据 库 的 key 的 数量 。 
redis> DBSIZE 
(integer) 5 


redis> SET new_key "hello_moto" # 增加 一 个 key 试 试 
OK 


redis> DBSIZE 
(integer) 6 


DEBUG OBJECT 


DEBUG OBJECT key 

DEBUG OBJECT 是 一 个 调试 命 售 ， 它 不 应 被 客户 端 所 使 用 。 

查看 OBJECT 命令 获 取 更 多 信息 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

当 key 存在 时 ， 返 回 有 关 信 息 。 当 key 不 存在 时 ， 返 回 一 个 错误 。 
redis> DEBUG OBJECT my_pc 


Value at:0xb6838d20 refcount:1 encoding:raw serializedlength:9 Jru 


redis> DEBUG OBJECT your_mac 
(error) ERR no such key 


[i 





DEBUG SEGFAULT 


DEBUG SEGFAULT 

执行 一 个 不 合法 的 内 存 访问 从 而 让 Redis 崩溃 ， 仅 在 开发 时 用 于 BUG 模拟 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

不 明确 

返回 值 : 

天 


redis> DEBUG SEGFAULT 
Could not connect to Redis at: Connection refused 


not connected> 


FLUSHALL 


FLUSHALL 

清空 整个 Redis 服务 器 的 数据 (删除 所 有 数据 库 的 所 有 key )。 
此 命令 从 不 失败 。 

可 用 版 本 : 

>= 1.0.0 


redis> DBSIZE #0 号 数据 库 的 key 数量 
(integer) 9 


redis> SELECT 1 # 切换 到 1 号 数据 库 
OK 


redis[1]> DBSIZE #1 号 数据 库 的 key 数量 
(integer) 6 


redis[1]> flushall # 清空 所 有 数据 库 的 所 有 key 
OK 


redis[1]> DBSIZE # 不 但 1 号 数据 库 被 清空 了 
(integer) 0 


redis[1]> SELECT 0 #0 号 数据 库 (以 及 其 他 所 有 数据 库 ) 也 一 样 
OK 


redis> DBSIZE 
(integer) 0 


FLUSHDB 


FLUSHDB 

清空 当前 数据 库 中 的 所 有 key。 
此 命令 从 不 失败 。 

可 用 版 本 : 

>= 1.0.0 


redis> DBSIZE # 清空 前 的 key 数量 
(integer) 4 


redis> FLUSHDB 
OK 


redis> DBSIZE # 清空 后 的 key 数量 
(integer) 0 


INFO 


INFO [section] 


以 一 种 易于 解释 (parse) 且 易 于 阅读 的 格式 ， 返 回 关于 Redis 服务 器 的 各 种 信息 
和 统计 数值 。 


通过 给 定 可 选 的 参数 section ， 可 以 让 命令 只 返回 某 一 部 分 的 信息 : 


server :一 般 Redis 服务 器 信息 ， 包 含 以 下 域 : 


> redis_version : Redis 服务 器 版 本 > redis_git_sha1 : Git SHA1 > 
redis_git_dirty :Gitdirtyflag> os : Redis 服务 器 的 宿主 操作 系统 > 
arch_bits :架构 (32 或 64 位 ) > multiplexing_api : Redis 所 使 用 的 

事件 处 理 机 制 > gcc_version :编译 Redis 时 所 使 用 的 GCC 版 本 > 
process_id :服务 器 进程 的 PID > run_id : Redis 服务 器 的 随机 标识 符 
(用 于 Sentinel 和 集群 ) > tcp_port : TCP/IP 监听 端口 > 
uptime_in_seconds : 自 Redis 服务 器 启动 以 来 ， 经 过 的 秒 数 > 
uptime_in_days : 自 Redis 服务 器 启动 以 来 ， 经 过 的 天 数 >* lru_clock 

: 以 分 钟 为 单位 进行 自 增 的 时 钟 ， 用 于 LRU 管理 


clients :已 连接 客户 端 信 息 ， 包 含 以 下 域 : 


> connected_clients :已 连接 客户 端的 数量 (不 包括 通过 从 属 服务 器 连接 
的 客户 端 ) > client_longest_output_list : 当前 连接 的 客户 端 当 中 ， 最 
长 的 输出 列表 > client_longest_input_buf :当前 连接 的 客户 端 当 中 ， 最 
大 输入 缓存 > blocked_clients :正在 等 竺 阻塞 命令 (BLPOP, BRPOP, 
BRPOPLPUSH) 的 客户 端的 数量 


memory : 内 存 信息 ， 包 含 以 下 域 : 


> used_memory :由 Redis 分 配器 分 配 的 内 存 总 量 ， 以 字 节 (byte) 为 单位 
> used_memory_human : 以 人 类 可 读 的 格式 返回 Redis 分 配 的 内 存 总 量 > 
used_memory_rss : 从 操作 系统 的 角度 ， 返 回 Redis 已 分 配 的 内 存 总 量 ( 众 
称 常 驻 集 大 小 ) 。 这 个 值 和 top 、 ps 等 命令 的 输出 一 致 。 > 
used_memory_peak : Redis 的 内 存 消耗 峰值 〈 以 字 节 为 单位 ) > 
used_memory_peak_human : 以 人 类 可 读 的 格式 返回 Redis 的 内 存 消耗 峰值 
> used_memory_lua :Lua 引擎 所 使 用 的 内 存 大 小 〈 以 字 节 为 单位 ) > 
mem_fragmentation_ratio : used_memory_rss 和 used_memory x] 
的 比率 > mem_allocator :在 编译 时 指定 的 ， Redis 所 使 用 的 内 存 分 配器 。 
可 以 是 libc 、 jemalloc 或 者 tcmalloc 。 > > 在 理想 情况 下 ， 

used_memory_rss 的 值 应 该 只 比 used_memory 稍微 高 一 点 儿 。 当 

rss &gt; used ， 且 两 者 的 值 相差 较 大 时 ， 表 示 存 在 (内 部 或 外 部 的 ) AF 
碎片。 内存 碎片 的 比率 可 以 通过 mem_fragmentation_ratio 的 值 看 出 。 当 
used &gt; rss 时 ， 表 示 Redis 的 部 分 内 存 被 操作 系统 换 出 到 交换 空间 了 ， 
在 这 种 情况 下 ， 操 作 可 能 会 产生 明显 的 延迟 。 > > Because Redis does not 
have control over how its allocations are mapped to memory pages, high 


used memory_rss is often the result of a a in memory usage. > > 4 
Redis 释放 内 存 时 ， 分 配器 可 能 会 ， 也 可 能 将 内 存 返 还 给 操作 系统 。 如 
R Redis 释放 了 内 存 ， 却 没有 将 内 存 返 还 给 操 ERI, 那么 used_memory 
的 值 可 能 和 操作 系统 显示 的 Redis 内 存 占用 并 不 一 致 。 查 看 
used_memory_peak 的 值 可 以 验证 这 种 情况 是 否 发 生 。 


e persistence : RDB 和 AOF 的 相关 信息 
e stats :一 般 统计 信息 
e replication : 主 /从 复制 信息 
e cpu :CPU 计算 量 统计 信息 
。 commandstats : Redis 命令 统计 信息 
e cluster : Redis 集群 信息 
e keyspace : 数据 库 相 关 的 统计 信息 
除 上 面 给 出 的 这 些 值 以 外 ， 参 数 还 可 以 是 下 面 这 


e all : 返回 所 有 信息 
e default : 返回 默认 选择 的 信息 


当 不 带 参 数 直 接 调用 INFO 命令 时 ， 使 用 default 作为 默认 参数 。 
Note 
不 同 版 本 的 Redis 可 能 对 返回 的 一 些 域 进行 了 增加 或 删 减 。 


因此 ， 一 个 健壮 的 客户 端 程序 在 对 INFO 命令 的 输出 进行 分 析 时 ， 应 该 能 够 跳 过 不 
认识 的 域 ， 并 且 受 善 地 处理 丢失 不 见 的 域 。 


可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

具体 请 参见 下 面 的 测试 代码 。 
redis> INFO 
# Server 
redis version:2.5.9 
redis_git_sha1:473f3090 
redis_git_dirty:0 
os:Linux 3.3.7-1-ARCH i686 


arch_bits:32 
multiplexing_api:epoll 


gcc_version:4.7.0 

process_id:8104 
run_id:bc9e20c6fOaac67d0d396ab950940ae4d1479ad1 
tcp_port:6379 

uptime_in_seconds:7 

uptime_in_days:0 

lru_clock:1680564 


# Clients 
connected_clients:1 
client_longest_output_list:0 
client_biggest_input_buf:0 
blocked_clients:0 


# Memory 

used_memory: 439304 
used_memory_human: 429.01K 
used_memory_rss:13897728 
used_memory_peak: 401776 
used_memory_peak_human:392.36K 
used_memory_lua: 20480 
mem_fragmentation_ratio:31.64 
mem_allocator:jemalloc-3.0.0 


# Persistence 

loading:0 
rdb_changes_since_last_save:0 
rdb_bgsave_in_progress:0 
rdb_last_save_time:1338011402 
rdb_last_bgsave_status:ok 
rdb_last_bgsave_time_sec:-1 
rdb_current_bgsave_time_sec: -1 
aof_enabled:0 
aof_rewrite_in_progress:0 
aof_rewrite_scheduled:0 
aof_last_rewrite_time_sec: -1 
aof_current_rewrite_time_sec:-1 





# Stats 
total_connections_received:1 
total_commands_processed:0 
instantaneous_ops_per_sec:0 
rejected_connections:0 
expired_keys:0 
evicted_keys:0 
keyspace_hits:0 
keyspace_misses:0 
pubsub_channels:0 
pubsub_patterns:0 
latest_fork_usec:0 


# Replication 
role:master 


connected_slaves:0 


# CPU 

used_cpu_sys:0.03 
used_cpu_user:0.01 
used_cpu_sys_children:0.00 
used_cpu_user_children:0.00 


# Keyspace 


LASTSAVE 


LASTSAVE 

返回 最 近 一 次 Redis 成 功 将 数据 保存 到 磁盘 上 的 时 间 ， 以 UNIX 时 间 惟 格式 表示 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

Wl) 4a : 

一 个 UNIX 时 间 惟 。 


redis> LASTSAVE 
(integer) 1324043588 


MONITOR 


MONITOR 

实时 打印 出 Redis 服务 器 接收 到 的 命 舍 ， 调 试用 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

不 明确 

返回 值 : 


总 是 返回 OK fe} 


127.0.0.1:6379> MONITOR 
OK 

# 以 第 一 个 打印 值 为 例 

# 1378822099.421623 At ja 

# [9 127.0.0.1:56604] 中 的 0 是 数据 库 号 码 ， 127... 是 IP 地 址 和 端口 
# "PING" 是 被 执行 的 命令 
1378822099.421623 [0 127. 
1378822105.089572 [0 127. 
1378822109.036925 [0 127. 


0 :56604] "PING" 

0 

0 
1378822140.649496 [0 127.0. 

0 

0 

0 


1 
1:56604] "SET" "msg" "hello world" 
1:56604] "SET" "number" "123" 
.1:56604] "SADD" "fruits" "Apple" "Bani 
1378822154.117160 [0 127. 1 
1378822257.329412 [0 127. 1 
1378822258.690131 [0 127. 1 


图 一 一 一 一 地 


:56604] "EXPIRE" "msg" "10086" 
756604] "KEYS" "*" 
:56604] "DBSIZE" 





PSYNC 


PSYNC <MASTER_RUN_ID> <OFFSET> 
用 于 复制 功能 (replication) 的 内 部 命 合 。 

更 多 信息 请 参考 复制 (Replication) 文档 。 
可 用 版 本 : 

>= 2.8.0 

时 间 复 杂 度 : 

不 明确 

返回 值 : 

不 明确 


127.0.0.1:6379> PSYNC ? -1 
"REDISOOO6\xfe\xOO\xOO\xO2kKk\xO2vvV\xOO\xO3msg\xO5hello\xff\xc3\x96I 


[E 





SAVE 


SAVE 


SAVE 命令 执行 一 个 同步 保存 操作 ， 将 当前 Redis 实例 的 所 有 数据 快照 (snapshot) 
以 RDB 文件 的 形式 保存 到 硬盘 。 


一 般 来 说 ， 在 生产 环境 很 少 执行 SAVE 操作 ， 因 为 它 会 阻塞 所 有 客户 端 ， 保 存 数据 
库 的 任务 通常 由 BGSAVE 命令 异步 地 执行 。 然 而 ， 如 果 负 责 保 存 数 据 的 后 台子 进 
程 不 笠 出 现 问题 时 ， SAVE 可 以 作为 保存 数据 的 最 后 手段 来 使 用 。 

请 参考 文档 : Redis 的 持久 化 运作 方式 (英文 ) 以 获取 更 多 消息 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复杂 度 : 

O(N), N 为 要 保存 到 数据 库 中 的 key 的 数量 。 

返回 值 : 

保存 成 功 时 返回 OK 。 


redis> SAVE 
OK 


SHUTDOWN 


SHUTDOWN 
SHUTDOWN 命令 执行 以 下 操作 : 

e 停止 所 有 客户 端 

e. 如 果 有 至 少 一 个 保存 点 在 等 待 ， 执 行 SAVE 命 兮 


e 如果 AOF 选项 被 打开 ， 更 新 AOF 文件 
e 关闭 redis 服务 器 (server) 


如 果 持 久 化 被 打开 的 话 ， SHUTDOWN 命令 会 保证 服务 器 正常 关闭 而 不 去 失 任 何 
BF 


另 一 方面 ， 假 如 只 是 单纯 地 执行 SAVE 命令 ， 然 后 再 执行 QUT RS, NRA 
保证 因为 在 执行 SAVE 之 后 、 执 行 QUIJ 厅 之 前 的 这 段 时 间 中 间 ， 其 他 客户 端 
可 能 正在 和 服务 器 进行 通讯 ， 这 时 如 果 执 行 QUIT 就 会 造成 数据 丢失 。 

SAVE 和 NOSAVE 修饰 符 

通过 使 用 可 选 的 修饰 符 ， 可 以 修改 SHUTDOWN 命令 的 表现 。 比 如 说 : 


e 执行 SHUTDOWN SAVE 会 强制 让 数据 库 执行 保存 操作 ， 即 使 没有 设 定 
(configure) 保 存 点 

e 执行 SHUTDOWN NOSAVE 会 阻止 数据 库 执行 保存 操作 ， 即 使 已 经 设 定 有 一 个 
或 多 个 保存 点 (你 可 以 将 这 一 用 法 看 作 是 强制 停止 服务 器 的 一 个 假想 的 ABORT 


an) 
可 用 版 本 : 
>= 1.0.0 
时 间 复 杂 度 : 
不 明确 
返回 值 : 


执行 失败 时 返回 错误 。 执 行 成 功 时 不 返回 任何 信息 ， 服 务 器 和 客户 端的 连接 断 开 ， 
客户 端 自动 退出 。 





redis> PING 
PONG 


redis> SHUTDOWN 
$ 
$ redis 


Could not connect to Redis at: Connection refused 
not connected> 


SLAVEOF 


SLAVEOF host port 
SLAVEOF 命令 用 于 在 Redis 运行 时 动态 地 修改 复制 (replication) 功 能 的 行为 。 


通过 执行 SLAVEOF host port 命 伟 ， 可 以 将 当前 服务 器 转变 为 指定 服务 器 的 从 
属 服务 器 (slave server), 


如 果 当 前 服务 器 已 经 是 某 个 主 服务 器 (master serven) 的 从 属 服务 器 ， 那 么 执行 
SLAVEOF host port 将 使 当前 服务 器 停止 对 旧 主 服务 器 的 同步 ， 丢 弃 旧 数据 
集 ， 转 而 开始 对 新 主 服务 器 进行 同步 。 


另外 ， 对 一 个 从 属 服务 器 执行 命令 SLAVEOF NO ONE 将 使 得 这 个 从 属 服务 器 关闭 
复制 功能 ， 并 从 从 属 服务 器 转变 回 主 服务 器 ， 原 来 同步 所 得 的 数据 集 不 会 被 丢弃 。 


利用 『 SLAVEOF NO ONE 不 会 丢弃 同步 所 得 数据 集 」 这 个 特性 ， 可 以 在 主 服 务 器 
失败 的 时 候 ， 将 从 属 服务 器 用 作 新 的 主 服 务 器 ， 从 而 实现 无 间断 运行 。 


可 用 版 本 : 
>= 1.0.0 
时 间 复 杂 度 : 


SLAVEOF host port , O(N), AN 为 要 同步 的 数据 数量 。 SLAVEOF NO ONE 
， O(1). 


返回 值 : 
总 是 返回 OK fe} 
redis> SLAVEOF 127.0.0.1 6379 


OK 


redis> SLAVEOF NO ONE 
OK 


SLOWLOG 


SLOWLOG subcommand [argument] 
什么 是 SLOWLOG 
Slow log 是 Redis 用 来 记录 查询 执行 时 间 的 日 志 系统 。 


查询 执行 时 间 指 的 是 不 包括 像 客户 端 响应 (talking)、 发 送 回 复 等 IO 操作 ， 而 单单 是 
执行 一 个 查询 命令 所 耗费 的 时 间 。 


另外 ，slow log 保存 在 内 存 里 面 ， 读 写 速 度 非常 快 ， 因 此 你 可 以 放心 地 使 用 它 ， 不 
必 担 心 因为 开启 slow log 而 损害 Redis 的 速度 。 


设置 SLOWLOG 


Slow log 的 行为 由 两 个 配置 参数 (configuration parameter) 指 定 ， 可 以 通过 改写 
redis.conf 文件 或 者 用 CONFIG GET 和 CONFIG SET 命令 对 它们 动态 地 进行 修 
改 。 


第 一 个 选项 是 slowlog-log-slower-than ， 它 决定 要 对 执行 时 间 大 于 多 少 微 秒 
(microsecond，1 秒 = 1,000,000 微 秒 ) 的 查询 进行 记录 。 
比如 执行 以 下 命令 将 让 slow log 记录 所 有 查询 时 间 大 于 等 于 100 微 秒 的 查询 : 
CONFIG SET slowlog-log-slower-than 100 
而 以 下 命令 记录 所 有 查询 时 间 大 于 1000 微 秒 的 查询 : 
CONFIG SET slowlog-log-slower-than 1000 


另 一 个 选项 是 slowlog-max-len , GRE slow log 最 多 能 保存 多 少 条 日 志 ， 


slow log 本 身 是 一 个 FIFO 队列 ， 当 队列 大 小 超过 slowlog-max-len 时 ， 最 旧 的 
一 条 日 志 将 被 删除 ， 而 最 新 的 一 条 日 志 加 入 到 slow log ， 以 此 类 推 。 


以 下 命令 让 slow log 最 多 保存 1000 条 日 志 : 

CONFIG SET slowlog-max-len 1000 

使 用 CONFIG GET 命令 可 以 查询 两 个 选项 的 当前 值 : 
redis> CONFIG GET slowlog-1log-slower -than 
1) "slowlog-log-slower-than" 
2) "1000" 
redis> CONFIG GET slowlog-max-len 


1) "slowlog-max-len" 
2) "1000" 


查看 slow log 


要 查看 slow log ， 可 以 使 用 SLOWLOG GET 或 者 SLOWLOG GET number QS, 
前 者 打印 所 有 slow log ， 最 大 长 度 取 决 于 slowlog-max-len 选项 的 值 ， 而 
SLOWLOG GET number 则 只 打印 指定 数量 的 日 志 。 


最 新 的 日 志 会 最 先 被 打印 : 
# 为 测试 需要 ， 将 slowlog-log-slower-than 设 成 了 10 微 秒 


redis> SLOWLOG GET 


1) 1) (integer) 12 # 唯一 性 (unique ) 的 日 志 标 识 符 
2) (integer) 1324097834 # 被 记录 命令 的 执行 时 间 点 ， 以 UN 
3) (integer) 16 # 查询 执行 时 间 ， 以 微 秒 为 单位 
4) 1) "CONFIG" # 执行 的 命令 ， 以 数组 的 形式 排列 

2) "GET" # 这 里 完整 的 命令 是 CONFIG GET 


3) "slowlog-1log-slower -than" 


2) 1) (integer) 11 
2) (integer) 1324097825 
3) (integer) 42 
4) 1) "CONFIG" 
2) "GET" 
3) Wk lt 


3) 1) (integer) 10 
2) (integer) 1324097820 
3) (integer) 11 
4) 1) "CONFIG" 
2) "GET" 
3) "slowlog-1log-slower -than" 





# ， 
dd = 
日 志 的 唯一 只 有 在 Redis 服务 器 重启 BANKS SE, 这 样 可 以 避免 对 日 志 的 


EE MEN SN ATES 8 时 发 邮件 通知 你 )。 
查看 当前 日 志 的 数量 

使 用 命令 SLOWLOG LEN 可 以 查看 当前 日 志 的 数量 。 

请 注意 这 个 值 和 slower-max-len 的 区 别 ， 它 们 一 个 是 当前 日 志 的 数量 ， 一 个 是 
允许 记录 的 最 大 日 志 的 数量 。 


redis> SLOWLOG LEN 
(integer) 14 


NaS = 
清空 日 志 


使 用 命令 SLOWLOG RESET 可 以 清空 slow log o 


redis> SLOWLOG LEN 
(integer) 14 


redis> SLOWLOG RESET 
OK 


redis> SLOWLOG LEN 
(integer) 0 

可 用 版 本 : 

>= 2.2.12 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

取决 于 不 同 命 售 ， 返 回 不 同 的 值 。 


SYNC 


SYNC 

用 于 复制 功能 (replication) 的 内 部 命 合 。 

更 多 信息 请 参考 Redis 官网 的 Replication 章节 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

不 明确 

返回 值 : 

不 明确 
redis> SYNC 
"REDISOO02\xfe\x00\x00\auser_id\xcO\x03\x00\anumber s\xc2\xf3\xeO\x( 
(1.90s) 

s|_ g 





TIME 


TIME 

返回 当前 服务 器 时 间 。 

可 用 版 本 : 

>= 2.6.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

一 个 包含 两 个 字符 串 的 列表 : 第 一 个 字符 串 是 当前 时 间 ( 以 UNIX 时 间 惟 格式 表 
示 )， 而 第 二 个 字符 串 是 当前 这 一 秒 钟 已 经 逝去 的 微 秒 数 。 


redis> TIME 
1) "1332395997" 
2) "952581" 
redis> TIME 
1) "1332395997" 
2) "953148" 


免责 声明 


W3School 提 供 的 内 容 仅 用 于 培训 。 我 们 不 保证 内 容 的 正确 性 。 通 过 使 用 本 站 内 容 
随 之 而 来 的 风险 与 本 站 无 关 。W3School 简 体 中 文 版 的 所 有 内 容 仅 供 测试 ， 对 任何 
法 律 问题 及 风险 不 承担 任何 责任 。 


